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.
Hinweis
Derzeit unterstützt PowerShell keine Typen für die Authentifizierung mithilfe verwalteter Identitäten zum Erstellen von Endpunkten. Wenn Sie die SAS-Authentifizierung in Ihrem Szenario nicht verwenden können, verwenden Sie eins der anderen Verwaltungstools, um Endpunkte zu erstellen.
Darüber hinaus unterstützt PowerShell derzeit das Erstellen von Cosmos DB-Endpunkten nicht.
Voraussetzungen
Sehen Sie sich die Voraussetzungen für diesen Artikel basierend auf dem Endpunkttyp an, an den Sie die Nachrichten weiterleiten möchten.
Ein Azure-Abonnement. Wenn Sie über kein Azure-Abonnement verfügen, können Sie ein kostenloses Azure-Konto erstellen, bevor Sie beginnen.
Einen IoT-Hub. Wenn Sie keinen Hub haben, können Sie die Schritte zum Erstellen eines IoT-Hubs ausführen.
Azure PowerShell. 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.
Eine Event Hubs-Ressource (mit Container). Wenn Sie eine neue Event Hubs-Ressource erstellen müssen, lesen Sie die Informationen unter Schnellstart: Erstellen eines Event Hubs.
(Empfohlen) Eine verwaltete Identität mit Berechtigungen der rollenbasierten Zugriffssteuerung für den Event Hubs-Namespace. Weitere Informationen finden Sie unter Authentifizieren einer verwalteten Identität mit Microsoft Entra ID für den Zugriff auf Event Hubs-Ressourcen.
Erstellen von 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.
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.
In den Befehlen in den folgenden Verfahren werden diese Verweise verwendet:
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 MyAuthRuleErstellen Sie einen neuen IoT Hub-Endpunkt für Event Hubs. Verwenden Sie Ihre primäre Verbindungszeichenfolge aus dem vorherigen Schritt. Der Wert für
EndpointTypemussEventHublauten. 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.
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.