Útvonalak és végpontok létrehozása és törlése a Azure PowerShell használatával

Ez a cikk bemutatja, hogyan hozhat létre útvonalat és végpontot a központban a Azure IoT Hub, majd hogyan törölheti az útvonalat és a végpontot. Megtudhatja, hogyan hozhat létre útvonalakat és végpontokat Azure Event Hubs, Azure Service Bus üzenetsorokhoz és témakörökhöz, valamint az Azure Storage-hoz Azure PowerShell használatával.

Ha többet szeretne megtudni arról, hogyan működik az útválasztás az IoT Hub-ben, olvassa el a 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 című témakört. Ha végig szeretne járni egy olyan útvonal beállításán, amely üzeneteket küld a tárolóba, majd tesztel egy szimulált eszközön, olvassa el az Oktatóanyag: Eszközadatok küldése az Azure Storage-ba IoT Hub üzenet útválasztásával című témakört.

Előfeltételek

A cikkben ismertetett eljárások a következő erőforrásokat használják:

• Azure PowerShell
• Egy IoT-központ
• Végpontszolgáltatás az Azure-ban

Azure PowerShell

Ez a cikk Azure PowerShell használ a IoT Hub és más Azure-szolgáltatásokkal való együttműködéshez. A Azure PowerShell helyi használatához telepítse a Azure PowerShell modult a számítógépre. Az Azure PowerShell webböngészőben való használatához engedélyezheti az Azure Cloud Shell.

IoT Hub

IoT Hub-útvonal létrehozásához szüksége van egy IoT Hubra, amelyet a Azure IoT Hub használatával hozott létre. Az eszközüzenetek és az eseménynaplók az IoT Hubról származnak.

Ügyeljen arra, hogy az IoT Hub-útvonal létrehozásakor a következő huberőforrást használja:

• Egy IoT Hub az Azure-előfizetésben. Ha még nem rendelkezik központtal, kövesse az IoT Hub létrehozásához szükséges lépéseket a New-AzIotHub PowerShell-parancsmag használatával.

Végpontszolgáltatás

IoT Hub-útvonal létrehozásához legalább egy másik Azure-szolgáltatásra van szüksége az útvonal végpontjaként való használatához. A végpont eszközüzeneteket és eseménynaplókat fogad. Kiválaszthatja, hogy melyik Azure-szolgáltatást használja egy végponthoz az IoT Hub útvonalához való csatlakozáshoz: Event Hubs, Service Bus-üzenetsorok vagy témakörök vagy Azure Storage.

Győződjön meg arról, hogy rendelkezik az alábbi erőforrások egyikével az IoT Hub-útvonal végpontjának létrehozásakor:

• Event Hubs-erőforrás (tárolóval). Ha új Event Hubs-erőforrást kell létrehoznia, olvassa el a Rövid útmutató: Eseményközpont létrehozása Azure PowerShell használatával című témakört.

• Egy Service Bus-üzenetsor-erőforrás. Ha új Service Bus-üzenetsort kell létrehoznia, olvassa el a Service Bus-névtér és -üzenetsor létrehozása Azure PowerShell című témakört.

• Egy Service Bus-témakör erőforrása. Ha új Service Bus-témakört kell létrehoznia, tekintse meg a New-AzServiceBusTopic referenciát és a Azure Service Bus üzenetkezelési dokumentációt.

• Egy Azure Storage-erőforrás. Ha új tárfiókot kell létrehoznia az Azure-ban, olvassa el a Tárfiók létrehozása című témakört.

Erőforrások és végpontok létrehozása

A IoT Hub létrehozhat egy útvonalat, amellyel üzeneteket küldhet vagy eseményeket rögzíthet. Minden útvonalhoz tartozik egy adatforrás és egy végpont. Az adatforrásból származnak az üzenetek vagy az eseménynaplók. A végponton végződnek az üzenetek vagy az eseménynaplók. Amikor új útvonalat hoz létre az IoT Hubon, az adatforrás és a végpont helyét választja ki. Ezután útválasztási lekérdezésekkel szűrheti az üzeneteket vagy eseményeket, mielőtt azok a végpontra lépnének.

Használhat eseményközpontot, Service Bus-üzenetsort vagy -témakört, vagy egy tárfiókot az IoT Hub útvonalának végpontjaként. A végpont létrehozásához használt szolgáltatásnak először az Azure-fiókjában kell lennie.

Megjegyzés

Ha a Azure PowerShell helyi verzióját használja, a kezdés előtt jelentkezzen be a Azure PowerShell.

Event Hubs

A következő eljárások parancsai a következő hivatkozásokat használják:

• Az.IotHub
• Az.EventHub

Eseményközpont létrehozása

Új Event Hubs-erőforrás létrehozása engedélyezési szabménnyel:

1. Hozzon létre egy új Event Hubs-névteret. A esetében NamespaceNamehasználjon egyedi értéket.

   New-AzEventHubNamespace -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Location MyLocation
   

2. Hozza létre az új Event Hubs-entitást. A esetében Namehasználjon egyedi értéket. A esetében NamespaceNamehasználja az előző lépésben létrehozott névtér nevét.

   New-AzEventHub -Name MyEventHub -NamespaceName MyNamespace -ResourceGroupName MyResourceGroup
   

3. Hozzon létre egy új engedélyezési szabályt. A esetében Namehasználja az entitás nevét a következőhöz EventHubName: . Az engedélyezési szabály nevéhez használjon egyedi értéket.

   New-AzEventHubAuthorizationRule -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule -Rights @('Manage', 'Send', 'Listen')
   

   A hozzáféréssel kapcsolatos további információkért lásd: Hozzáférés engedélyezése Azure Event Hubs.

Event Hubs-végpont létrehozása

1. Szerezze be az elsődleges kapcsolati sztring az eseményközpontból. Másolja a kapcsolati sztring a 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. A értéknek a EndpointType következőnek kell lennie EventHub: . Minden más 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.

Service Bus-üzenetsor

A következő eljárások parancsai a következő hivatkozásokat használják:

• Az.IotHub
• Az.ServiceBus

Service Bus-névtér és üzenetsor létrehozása

Új Service Bus-üzenetsor-erőforrás létrehozása:

1. Hozzon létre egy új Service Bus-névteret. A esetében Namehasználjon egyedi értéket.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Hozzon létre egy új Service Bus-üzenetsort. A esetében NamespaceNamehasználja az előző lépésben létrehozott névtér nevét. Az üzenetsor nevéhez használjon egyedi értéket.

   New-AzServiceBusQueue -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyQueue
   

Service Bus-üzenetsorvégpont létrehozása

Új Service Bus-üzenetsorvégpont létrehozása:

1. Kérje le az elsődleges kapcsolati sztring a Service Bus-névtérből. Másolja a kapcsolati sztring a későbbi használatra.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Hozzon létre egy új IoT Hub-végpontot a Service Bus-üzenetsorhoz. Használja az előző lépésben szereplő elsődleges kapcsolati sztring, és ;EntityPath=MyServiceBusQueue adja hozzá a végéhez. A értéknek a EndpointType következőnek kell lennie ServiceBusQueue: . Minden más paraméterhez használja a forgatókönyv értékeit. A esetében EndpointNamehasználjon egyedi értéket.

   Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType EventHub -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "Endpoint=my-connection-string;EntityPath=MyServiceBusQueue"
   

   Az útválasztási végpontok beállításainak listáját az Add-AzIotHubRoutingEndpoint című témakörben találja.

Service Bus-témakör

A következő eljárások parancsai a következő hivatkozásokat használják:

• Az.IotHub
• Az.ServiceBus

A Service Bus-témakörökkel a felhasználók feliratkozhatnak egy vagy több témakörre. Témakör létrehozásához létre kell hoznia egy Service Bus-névteret és egy előfizetést is.

Service Bus-névtér, témakör és előfizetés létrehozása

1. Hozzon létre egy új Service Bus-névteret. A Name névtérhez használjon egyedi értéket.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Hozzon létre egy új Service Bus-témakört. A témakör neveként használjon egyedi értéket.

   New-AzServiceBusTopic -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyTopic
   

3. Hozzon létre egy új előfizetést a témakörhöz. A esetében TopicNamehasználja az előző lépésben létrehozott témakör nevét. Az előfizetés nevéhez használjon egyedi értéket.

   New-AzServiceBusSubscription -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -TopicName MyTopic -Name MySubscription
   

Service Bus-témakörvégpont létrehozása

1. Kérje le az elsődleges kapcsolati sztring a Service Bus-névtérből. Másolja a kapcsolati sztring a későbbi használatra.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Hozzon létre egy új IoT Hub-végpontot a Service Bus-témakörhöz. Használja az előző lépésben szereplő elsődleges kapcsolati sztring, és ;EntityPath=MyServiceBusTopic adja hozzá a végéhez. A értéknek a EndpointType következőnek kell lennie ServiceBusTopic: . Minden más paraméterhez használja a forgatókönyv értékeit. A esetében EndpointNamehasználjon egyedi értéket.

   Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType ServiceBusTopic -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "Endpoint=<my connection string>;EntityPath=MyServiceBusTopic"
   

   Az útválasztási végpontok beállításainak listáját az Add-AzIotHubRoutingEndpoint című témakörben találja.

Azure Storage

A következő eljárások parancsai a következő hivatkozásokat használják:

• Az.IotHub
• Az.Storage

Azure Storage-végpont és -útvonal létrehozásához egy Storage-fiókra és -tárolóra van szükség.

Azure Storage-fiók és -tároló létrehozása

1. Hozzon létre egy új Azure Storage-fiókot. A tárfiók értéke Name csak kisbetűket és számokat tartalmazhat. A SkuName beállításokért lásd: SkuName.

   New-AzStorageAccount -ResourceGroupName MyResourceGroup -Name mystorageaccount -Location westus -SkuName Standard_GRS
   

2. Hozzon létre egy új tárolót a tárfiókban. Létre kell hoznia egy környezetet a tárfiókhoz egy változóban, majd hozzá kell adnia a változót a Context paraméterhez. A tárolók létrehozásakor elérhető lehetőségekről további információt a Blobtárolók kezelése a PowerShell használatával című témakörben talál. A esetében Namehasználjon egyedi értéket a tároló nevéhez.

   $ctx = New-AzStorageContext -StorageAccountName mystorageaccount -UseConnectedAccount `
   New-AzStorageContainer -Name ContainerName -Context $ctx
   

Azure Storage-végpont létrehozása

Az Azure Storage-hoz végpont létrehozásához a hozzáférési kulcsra van szüksége egy kapcsolati sztring létrehozásához. A kapcsolati sztring ezután a végpont létrehozásához szükséges IoT Hub parancs része.

1. Kérje le a hozzáférési kulcsot a tárfiókból, majd másolja ki.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Hozzon létre egy elsődleges kapcsolati sztring a tárfiókhoz az alábbi sablon alapján. Cserélje le mystorageaccount (két helyen) a tárfiók nevére. Cserélje le a elemet mykey az előző lépésben szereplő kulcsra.

   "DefaultEndpointsProtocol=https;BlobEndpoint=https://mystorageaccount.blob.core.windows.net;AccountName=mystorageaccount;AccountKey=mykey"
   

   Ez a kapcsolati sztring szükséges a végpont létrehozásához szükséges lépésben.

3. Hozza létre az Azure Storage-végpontot a létrehozott kapcsolati sztring. EndpointType értéknek azurestoragekell lennie. Minden más paraméterhez használja a forgatókönyv értékeit. A esetében EndpointNamehasználjon egyedi értéket.

   Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType azurestorage -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "my connection string"
   

4. Amikor a rendszer kéri a tároló nevét, adja meg a tároló nevét, majd válassza az Enter lehetőséget a végpont létrehozásához.

IoT Hub-útvonal létrehozása

Az IoT Hub új végpontjával létrehozhat egy új útvonalat.

A IoT Hub alapértelmezett tartalék útvonala a következőből DeviceMessagesgyűjt üzeneteket: . 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 paranccsal.

Set-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute

Get-AzIotHubRoute Az paranccsal erősítse meg az útvonal változását:

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. Egy 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 Hubs, a Service Bus-üzenetsorok és -témakörök, valamint az Azure Storage számára.

Az üzenet-útválasztással kapcsolatos további információkért lásd: Oktatóanyag: Eszközadatok küldése az Azure Storage-ba IoT Hub üzenetirányítás használatával. Az oktatóanyagban létrehoz egy tárolási útvonalat, és teszteli azt az IoT Hub egyik eszközével.