Erstellen und Löschen von Routen und Endpunkten mit Azure PowerShell

In diesem Artikel erfahren Sie, wie Sie in Ihrem Hub in Azure IoT Hub eine Route und einen Endpunkt erstellen und beide anschließend löschen. Erfahren Sie, wie Sie mithilfe von Azure PowerShell Routen und Endpunkte für Azure Event Hubs, Azure Service Bus-Warteschlangen und -Themen sowie für Azure Storage erstellen.

Weitere Informationen zur Funktionsweise des Routings in IoT Hub finden Sie unter Verwenden des IoT Hub-Nachrichtenroutings zum Senden von D2C-Nachrichten an verschiedene Endpunkte. Informationen zum Einrichten einer Route, die Nachrichten an den Speicher sendet, mit anschließendem Testen auf einem simulierten Gerät finden Sie im Tutorial: Senden von Gerätedaten an Azure Storage über IoT Hub-Nachrichtenrouting.

Voraussetzungen

Bei den in diesem Artikel beschriebenen Verfahren werden die folgenden Ressourcen verwendet:

• Azure PowerShell
• Ein IoT Hub
• Ein Endpunktdienst in Azure

Azure PowerShell

In diesem Artikel wird Azure PowerShell zum Arbeiten mit IoT Hub und anderen Azure-Diensten verwendet. Wenn Sie Azure PowerShell lokal verwenden möchten: Installieren Sie das Azure PowerShell-Modul auf Ihrem Computer. Alternativ dazu können Sie Azure PowerShell in einem Webbrowser nutzen, indem Sie Azure Cloud Shell aktivieren.

IoT Hub

Zum Erstellen einer IoT-Hub-Route benötigen Sie einen IoT-Hub, den Sie mithilfe von Azure IoT Hub erstellt haben. Gerätemeldungen und Ereignisprotokolle stammen aus Ihrem IoT-Hub.

Beim Erstellen Ihrer IoT-Hub-Route müssen Sie die folgende Hubressource verwenden:

• Ein IoT-Hub in Ihrem Azure-Abonnement. Wenn Sie noch keinen Hub haben, können Sie die Schritte unter Erstellen eines IoT-Hubs mit dem PowerShell-Cmdlet „New-AzIotHub“ ausführen.

Endpunktdienst

Zum Erstellen einer IoT-Hub-Route benötigen Sie mindestens einen anderen Azure-Dienst, der als Endpunkt für die Route verwendet werden soll. Der Endpunkt empfängt Gerätenachrichten und Ereignisprotokolle. Sie können wählen, welchen Azure-Dienst Sie für einen Endpunkt verwenden möchten, der eine Verbindung mit Ihrer IoT-Hub-Route herstellen soll: Event Hubs, Service Bus-Warteschlangen oder -Themen oder aber Azure Storage.

Sie müssen eine der folgenden Ressourcen verwenden, wenn Sie einen Endpunkt für Ihre IoT-Hub-Route erstellen:

• Eine Event Hubs-Ressource (mit Container). Wenn Sie eine neue Event Hubs-Ressource erstellen müssen, lesen Sie die Informationen im Schnellstart: Erstellen einer Event Hub-Instanz mithilfe von Azure PowerShell.

• Eine Service Bus-Warteschlangenressource. Wenn Sie eine neue Service Bus-Warteschlange erstellen müssen, lesen Sie die Informationen unter Verwenden von Azure PowerShell zum Erstellen eines Service Bus-Namespace und einer Warteschlange.

• Eine Service Bus-Themenressource. Wenn Sie ein neues Service Bus-Thema erstellen müssen, lesen Sie die Referenz zu New-AzServiceBusTopic und die Dokumentation zum Azure Service Bus-Messaging.

• Eine Azure Storage-Ressource. Informationen zum Erstellen eines neuen Speicherkontos in Azure finden Sie unter Erstellen eines Speicherkontos.

Erstellen von Ressourcen und Endpunkten

In IoT Hub können Sie eine Route erstellen, um Nachrichten zu senden oder Ereignisse zu erfassen. Bei jeder Route gibt es eine Datenquelle und einen Endpunkt. Die Datenquelle ist der Ursprung von Nachrichten oder Ereignisprotokollen. Der Endpunkt ist der Ort, an dem die Nachrichten oder Ereignisprotokolle enden. Sie wählen Speicherorte für die Datenquelle und den Endpunkt aus, wenn Sie in Ihrem IoT-Hub eine neue Route erstellen. Anschließend verwenden Sie Routingabfragen zum Filtern von Nachrichten oder Ereignissen, bevor sie zum Endpunkt gelangen.

Sie können einen Event Hub, eine Service Bus-Warteschlange oder ein Service Bus-Thema oder ein Speicherkonto als Endpunkt für Ihre IoT-Hub-Route verwenden. Der Dienst, den Sie zum Erstellen Ihres Endpunkts verwenden, muss in Ihrem Azure-Konto zuerst vorhanden sein.

Hinweis

Wenn Sie eine lokale Version von Azure PowerShell verwenden, melden Sie sich bei Azure PowerShell an, bevor Sie beginnen.

Event Hubs

In den Befehlen in den folgenden Verfahren werden diese Verweise verwendet:

• Az.IotHub
• Az.EventHub

Erstellen eines Ereignis-Hubs

So erstellen Sie eine neue Event Hubs-Ressource mit einer Autorisierungsregel

1. Erstellen Sie einen neuen Event Hubs-Namespace. Verwenden Sie für NamespaceName einen eindeutigen Wert.

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

2. Erstellen Sie Ihre neue Event Hubs-Entität. Verwenden Sie für Name einen eindeutigen Wert. Verwenden Sie für NamespaceName den Namen des Namespace, den Sie im vorhergehenden Schritt erstellt haben.

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

3. Erstellen Sie eine neue Autorisierungsregel. Verwenden Sie für Name den Namen Ihrer Entität für EventHubName. Verwenden Sie als Namen Ihrer Autorisierungsregel einen eindeutigen Wert.

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

   Weitere Informationen zum Zugriff finden Sie unter Autorisieren des Zugriffs auf Azure Event Hubs.

Erstellen eines Event Hubs-Endpunkts

1. Rufen Sie die primäre Verbindungszeichenfolge aus Ihrem Event Hub ab. Kopieren Sie die Verbindungszeichenfolge zur späteren Verwendung.

   Get-AzEventHubKey -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule
   

2. Erstellen Sie einen neuen IoT Hub-Endpunkt für Event Hubs. Verwenden Sie Ihre primäre Verbindungszeichenfolge aus dem vorherigen Schritt. Der Wert für EndpointType muss EventHub lauten. Verwenden Sie bei allen anderen Parametern Werte für Ihr Szenario.

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

   Alle Optionen für Routingendpunkte finden Sie unter Add-AzIotHubRoutingEndpoint.

Service Bus-Warteschlange

In den Befehlen in den folgenden Verfahren werden diese Verweise verwendet:

• Az.IotHub
• Az.ServiceBus

Erstellen eines Service Bus-Namespaces und einer Warteschlange

So erstellen Sie eine neue Service Bus-Warteschlangenressource

1. Erstellen Sie einen neuen Service Bus-Namespace. Verwenden Sie für Name einen eindeutigen Wert.

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

2. Erstellen Sie eine neue Service Bus-Warteschlange. Verwenden Sie für NamespaceName den Namen des Namespace, den Sie im vorhergehenden Schritt erstellt haben. Verwenden Sie als Namen Ihrer Warteschlange einen eindeutigen Wert.

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

Erstellen eines Service Bus-Warteschlangenendpunkts

So erstellen Sie einen neuen Service Bus-Warteschlangenendpunkt

1. Rufen Sie die primäre Verbindungszeichenfolge aus Ihrem Service Bus-Namespace ab. Kopieren Sie die Verbindungszeichenfolge zur späteren Verwendung.

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

2. Erstellen Sie für Ihre Service Bus-Warteschlange einen neuen IoT Hub-Endpunkt. Verwenden Sie Ihre primäre Verbindungszeichenfolge aus dem vorherigen Schritt mit der Ergänzung ;EntityPath=MyServiceBusQueue am Ende. Der Wert für EndpointType muss ServiceBusQueue lauten. Verwenden Sie bei allen anderen Parametern Werte für Ihr Szenario. Verwenden Sie für EndpointName einen eindeutigen Wert.

   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"
   

   Eine Liste aller Optionen für Routingendpunkte finden Sie unter Add-AzIotHubRoutingEndpoint.

Service Bus-Topic

In den Befehlen in den folgenden Verfahren werden diese Verweise verwendet:

• Az.IotHub
• Az.ServiceBus

Mit Service Bus-Themen können Benutzer mindestens ein Thema abonnieren. Um ein Thema zu erstellen, müssen Sie auch einen Service Bus-Namespace und ein Abonnement erstellen.

Erstellen eines Service Bus-Namespaces, -Themas und -Abonnements

1. Erstellen Sie einen neuen Service Bus-Namespace. Verwenden Sie für Name einen eindeutigen Wert für Ihren Namespace.

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

2. Erstellen Sie ein neues Service Bus-Thema. Verwenden Sie als Themennamen einen eindeutigen Wert.

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

3. Erstellen Sie ein neues Abonnement für Ihr Thema. Verwenden Sie für TopicName den Namen des Themas, das Sie im vorhergehenden Schritt erstellt haben. Verwenden Sie als Abonnementnamen einen eindeutigen Wert.

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

Erstellen eines Service Bus-Themaendpunkts

1. Rufen Sie die primäre Verbindungszeichenfolge aus Ihrem Service Bus-Namespace ab. Kopieren Sie die Verbindungszeichenfolge zur späteren Verwendung.

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

2. Erstellen Sie für Ihr Service Bus-Thema einen neuen IoT Hub-Endpunkt. Verwenden Sie Ihre primäre Verbindungszeichenfolge aus dem vorherigen Schritt mit der Ergänzung ;EntityPath=MyServiceBusTopic am Ende. Der Wert für EndpointType muss ServiceBusTopic lauten. Verwenden Sie bei allen anderen Parametern Werte für Ihr Szenario. Verwenden Sie für EndpointName einen eindeutigen Wert.

   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"
   

   Eine Liste aller Optionen für Routingendpunkte finden Sie unter Add-AzIotHubRoutingEndpoint.

Azure Storage (in englischer Sprache)

In den Befehlen in den folgenden Verfahren werden diese Verweise verwendet:

• Az.IotHub
• Az.Storage

Zum Erstellen eines Azure Storage-Endpunkts und einer Route benötigen Sie ein Speicherkonto und einen Container.

Erstellen eines Azure Storage-Kontos und Containers

1. Erstellen Sie ein neues Azure Storage-Konto. Der Wert von Name für Ihr Speicherkonto darf nur Kleinbuchstaben und Zahlen enthalten. Optionen für SkuName finden Sie unter SkuName.

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

2. Erstellen Sie in Ihrem Speicherkonto einen neuen Container. Sie müssen einen Kontext für Ihr Speicherkonto in einer Variablen erstellen und diesen dann dem Context-Parameter hinzufügen. Informationen zu den Optionen beim Erstellen eines Containers finden Sie unter Verwalten von Blobcontainern mit PowerShell. Verwenden Sie für Name einen eindeutigen Wert als Containernamen.

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

Erstellen eines Azure Storage-Endpunkts

Zum Erstellen eines Endpunkts für Azure Storage benötigen Sie Ihren Zugriffsschlüssel, um eine Verbindungszeichenfolge zu erstellen. Die Verbindungszeichenfolge ist anschließend Teil des IoT Hub-Befehls zur Erstellung eines Endpunkts.

1. Rufen Sie Ihren Zugriffsschlüssel aus Ihrem Speicherkonto ab, und kopieren Sie ihn.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Erstellen Sie basierend auf der folgenden Vorlage eine primäre Verbindungszeichenfolge für Ihr Speicherkonto. Ersetzen Sie mystorageaccount (an zwei Stellen) durch den Namen Ihres Speicherkontos. Ersetzen Sie mykey durch Ihren Schlüssel aus dem vorherigen Schritt.

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

   Diese Verbindungszeichenfolge ist bei diesem Schritt erforderlich, um den Endpunkt zu erstellen.

3. Erstellen Sie Ihren Azure Storage-Endpunkt mit der Verbindungszeichenfolge, die Sie gebildet haben. EndpointType muss den Wert azurestorage aufweisen. Verwenden Sie bei allen anderen Parametern Werte für Ihr Szenario. Verwenden Sie für EndpointName einen eindeutigen Wert.

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

4. Wenn Sie zur Eingabe Ihres Containernamens aufgefordert werden, geben Sie diesen ein und drücken dann die EINGABETASTE, um den Endpunkt zu erstellen.

Erstellen einer IoT Hub-Route

Mit dem neuen Endpunkt in Ihrem IoT-Hub können Sie eine neue Route erstellen.

Die Standard-Fallbackroute in IoT Hub sammelt Nachrichten aus DeviceMessages. Wählen Sie für Ihre benutzerdefinierte Route eine andere Option, z. B. DeviceConnectionStateEvents. Weitere Informationen zu Quelloptionen finden Sie unter Add-AzIotHubRoute. Der Enabled-Parameter ist ein Schalter, daher müssen Sie für diesen Parameter keinen Wert verwenden.

Add-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -Source DeviceLifecycleEvents -EndpointName MyEndpoint -Enabled

PowerShell zeigt eine Bestätigung an, die diesem Beispiel ähnelt:

RouteName     : MyIotHub 
DataSource    : DeviceLifecycleEvents
EndpointNames : MyEndpoint
Condition     : true
IsEnabled     : True

Aktualisieren einer IoT Hub-Route

Nehmen Sie mit dem folgenden Befehl Änderungen an einer vorhandenen Route vor. Versuchen Sie beispielsweise, den Namen Ihrer Route mithilfe des Befehls zu ändern.

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

Verwenden Sie den Befehl Get-AzIotHubRoute, um die Änderung in Ihrer Route zu bestätigen:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Einen Endpunkt löschen

So löschen Sie einen Endpunkt:

Remove-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -PassThru

Löschen einer IoT Hub-Route

So löschen Sie eine IoT Hub-Route:

Remove-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -PassThru

Tipp

Durch das Löschen einer Route werden in Ihrem Azure-Konto keine Endpunkte gelöscht. Sie müssen einen Endpunkt getrennt vom Löschen einer Route löschen.

Nächste Schritte

In diesem Artikel mit Anleitungen haben Sie erfahren, wie Sie eine Route und einen Endpunkt für Event Hubs, Service Bus-Warteschlangen und -Themen sowie für Azure Storage erstellen.

Weitere Informationen zum Nachrichtenrouting finden Sie im Tutorial: Senden von Gerätedaten an Azure Storage über IoT Hub-Nachrichtenrouting. In diesem Tutorial erstellen Sie eine Speicherroute und testen sie mit einem Gerät in Ihrem IoT-Hub.