Megosztás a következőn keresztül:


Ú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.

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:

  1. 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
    
  2. 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 lennie EventHub: . 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.