Útvonalak és végpontok létrehozása és törlése az Azure PowerShell használatával
Ez a cikk bemutatja, hogyan hozhat létre útvonalat és végpontot a központban az Azure IoT Hubban, majd törölheti az útvonalat és a végpontot. Megtudhatja, hogyan hozhat létre útvonalakat és végpontokat az Azure Event Hubshoz, az Azure Service Bus-üzenetsorokhoz és -témakörökhöz, valamint az Azure Storage-hoz az Azure PowerShell használatával.
Az IoT Hubban az útválasztás működésével kapcsolatos további információkért lásd : Az IoT Hub üzenet-útválasztás használata az eszközről a felhőbe irányuló üzenetek különböző végpontokra való küldéséhez. Ha végig szeretne járni egy olyan útvonal beállításán, amely üzeneteket küld a tárolóba, majd szimulált eszközön tesztel, tekintse meg az oktatóanyagot: Eszközadatok küldése az Azure Storage-ba az IoT Hub üzenet-útválasztásával.
Feljegyzés
A PowerShell jelenleg nem támogatja a felügyelt identitáshitelesítési típusokat végpontok létrehozásához. Ha nem tudja használni az SAS-hitelesítést a forgatókönyvben, használja a többi felügyeleti eszköz egyikét végpontok létrehozásához.
A PowerShell jelenleg nem támogatja a Cosmos DB-végpontok létrehozását.
Előfeltételek
Tekintse át a cikk előfeltételeit annak alapján, hogy milyen típusú végpontra szeretné irányítani az üzeneteket.
Azure-előfizetés. Ha nem rendelkezik Azure-előfizetéssel, mindössze néhány perc alatt létrehozhat egy ingyenes Azure-fiókot a virtuális gép létrehozásának megkezdése előtt.
Egy IoT Hub. Ha nem rendelkezik hubbal, kövesse az IoT Hub létrehozásához szükséges lépéseket.
Azure PowerShell. Az Azure PowerShell helyi használatához telepítse az Azure PowerShell modult a számítógépre. Ha az Azure PowerShellt webböngészőben szeretné használni, engedélyezze az Azure Cloud Shellt.
Event Hubs-erőforrás (tárolóval). Ha új Event Hubs-erőforrást kell létrehoznia, tekintse meg a rövid útmutatót: Eseményközpont létrehozása.
(Ajánlott) Felügyelt identitás szerepköralapú hozzáférés-vezérlési engedélyekkel az Event Hubs-névtérhez. További információ: Felügyelt identitás hitelesítése Microsoft Entra-azonosítóval az Event Hubs-erőforrások eléréséhez.
Végpontok létrehozása
Az IoT Hubban létrehozhat egy útvonalat, amellyel üzeneteket küldhet vagy eseményeket rögzíthet. Minden útvonal rendelkezik adatforrással és végpontokkal. Az adatforrás az, ahonnan üzenetek vagy eseménynaplók származnak. A végponton végződnek az üzenetek vagy az eseménynaplók. Amikor új útvonalat hoz létre az IoT Hubon, kiválaszthatja az adatforrás és a végpont helyét. Ezután útválasztási lekérdezésekkel szűrheti az üzeneteket vagy eseményeket, mielőtt azok a végpontra kerülnének.
A végpont létrehozásához használt szolgáltatásnak először az Azure-fiókjában kell lennie.
Feljegyzés
Ha az Azure PowerShell helyi verzióját használja, a kezdés előtt jelentkezzen be az Azure PowerShellbe .
A következő eljárások parancsai a következő hivatkozásokat használják:
Szerezze be az elsődleges kapcsolati sztring az eseményközpontból. Másolja a kapcsolati sztring későbbi használatra.
Get-AzEventHubKey -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule
Hozzon létre egy új IoT Hub-végpontot az Event Hubsban. Használja az előző lépésben szereplő elsődleges kapcsolati sztring. Az értéknek a következőnek
EndpointType
kell lennieEventHub
: . Az összes többi paraméterhez használja a forgatókönyv értékeit.Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType EventHub -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "Endpoint=<my connection string>"
Az útválasztási végpont összes beállításának megtekintéséhez lásd: Add-AzIotHubRoutingEndpoint.
IoT Hub-útvonal létrehozása
Az IoT Hub új végpontjával létrehozhat egy új útvonalat.
Az IoT Hub alapértelmezett tartalék útvonala üzeneteket gyűjt.DeviceMessages
Válasszon egy másik lehetőséget az egyéni útvonalhoz, például DeviceConnectionStateEvents
. További információ a forrásbeállításokról: Add-AzIotHubRoute. A Enabled
paraméter egy kapcsoló, így nem kell értéket használnia a paraméterrel.
Add-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -Source DeviceLifecycleEvents -EndpointName MyEndpoint -Enabled
A PowerShell az alábbi példához hasonló megerősítést jelenít meg:
RouteName : MyIotHub
DataSource : DeviceLifecycleEvents
EndpointNames : MyEndpoint
Condition : true
IsEnabled : True
IoT Hub-útvonal frissítése
Meglévő útvonal módosításához használja az alábbi parancsot. Próbálja meg például módosítani az útvonal nevét a parancs használatával.
Set-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute
Az útvonal változásának megerősítéséhez használja a Get-AzIotHubRoute
parancsot:
Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub
Végpont törlése
Végpont törlése:
Remove-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -PassThru
IoT Hub-útvonal törlése
IoT Hub-útvonal törlése:
Remove-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -PassThru
Tipp.
Az útvonal törlése nem törli az Azure-fiókjában lévő végpontokat. A végpontot külön kell törölnie az útvonal törlésétől.
Következő lépések
Ebben az útmutatócikkben megtanulta, hogyan hozhat létre útvonalat és végpontot az Event Hubshoz, a Service Bus-üzenetsorokhoz és -témakörökhöz, valamint az Azure Storage-hoz.
Az üzenet-útválasztással kapcsolatos további információkért tekintse meg az oktatóanyagot: Eszközadatok küldése az Azure Storage-ba az IoT Hub üzenet-útválasztásával. Az oktatóanyagban létrehoz egy tárolási útvonalat, és teszteli azt egy eszköz használatával az IoT Hubon.