Routes en eindpunten maken en verwijderen met behulp van Azure PowerShell

In dit artikel leest u hoe u een route en eindpunt maakt in uw hub in Azure IoT Hub en vervolgens uw route en eindpunt verwijdert. Meer informatie over het gebruik van Azure PowerShell voor het maken van routes en eindpunten voor Azure Event Hubs, Azure Service Bus-wachtrijen en onderwerpen en Azure Storage.

Zie IoT Hub-berichtroutering gebruiken om apparaat-naar-cloud-berichten naar verschillende eindpunten te verzenden voor meer informatie over hoe routering werkt in IoT Hub. Zie zelfstudie: Apparaatgegevens verzenden naar Azure Storage met behulp van IoT Hub-berichtroutering om stapsgewijs een route in te stellen waarmee berichten naar de opslag worden verzonden en vervolgens op een gesimuleerd apparaat worden getest.

Notitie

Momenteel biedt PowerShell geen ondersteuning voor verificatietypen voor beheerde identiteiten voor het maken van eindpunten. Als u geen SAS-verificatie in uw scenario kunt gebruiken, gebruikt u een van de andere beheerprogramma's om eindpunten te maken.

PowerShell biedt momenteel ook geen ondersteuning voor het maken van Cosmos DB-eindpunten.

Vereisten

Bekijk de vereisten voor dit artikel op basis van het type eindpunt waarnaar u de berichten wilt routeren.

Event Hubs

• Een Azure-abonnement. Als u nog geen abonnement op Azure hebt, maakt u een gratis Azure-account voordat u begint.

• Een IoT-hub. Als u geen hub hebt, kunt u de stappen volgen om een IoT-hub te maken.

• Azure PowerShell. Als u Azure PowerShell lokaal wilt gebruiken, installeert u de Azure PowerShell-module op uw computer. Als u Azure PowerShell in een webbrowser wilt gebruiken, schakelt u Azure Cloud Shell in.

• Een Event Hubs-resource (met container). Als u een nieuwe Event Hubs-resource wilt maken, raadpleegt u quickstart: Een Event Hub maken.

• (Aanbevolen) Een beheerde identiteit met op rollen gebaseerde toegangsbeheermachtigingen voor de Event Hubs-naamruimte. Zie Een beheerde identiteit verifiëren met Microsoft Entra ID voor toegang tot Event Hubs-resources voor meer informatie.

Service Bus-wachtrij

• Een Azure-abonnement. Als u nog geen abonnement op Azure hebt, maakt u een gratis Azure-account voordat u begint.

• Een IoT-hub. Als u geen hub hebt, kunt u de stappen volgen om een IoT-hub te maken.

• Azure PowerShell. Als u Azure PowerShell lokaal wilt gebruiken, installeert u de Azure PowerShell-module op uw computer. Als u Azure PowerShell in een webbrowser wilt gebruiken, schakelt u Azure Cloud Shell in.

• Een Service Bus-wachtrijresource. Als u een nieuwe Service Bus-wachtrij wilt maken, raadpleegt u quickstart: Een Service Bus-naamruimte en een wachtrij maken.

• (Aanbevolen) Een beheerde identiteit met op rollen gebaseerd toegangsbeheermachtigingen voor de Service Bus-naamruimte of -wachtrij. Zie Een beheerde identiteit verifiëren met Microsoft Entra ID voor toegang tot Azure Service Bus-resources voor meer informatie

Service Bus-onderwerp

• Een Azure-abonnement. Als u nog geen abonnement op Azure hebt, maakt u een gratis Azure-account voordat u begint.

• Een IoT-hub. Als u geen hub hebt, kunt u de stappen volgen om een IoT-hub te maken.

• Azure PowerShell. Als u Azure PowerShell lokaal wilt gebruiken, installeert u de Azure PowerShell-module op uw computer. Als u Azure PowerShell in een webbrowser wilt gebruiken, schakelt u Azure Cloud Shell in.

• Een Service Bus-onderwerpresource. Als u een nieuw Service Bus-onderwerp wilt maken, raadpleegt u quickstart: Een Service Bus-naamruimte maken met onderwerp en abonnement met behulp van een Resource Manager-sjabloon.

• (Aanbevolen) Een beheerde identiteit met op rollen gebaseerde toegangsbeheermachtigingen voor de Service Bus-naamruimte of het onderwerp. Zie Een beheerde identiteit verifiëren met Microsoft Entra ID voor toegang tot Azure Service Bus-resources voor meer informatie

Azure Storage

• Een Azure-abonnement. Als u nog geen abonnement op Azure hebt, maakt u een gratis Azure-account voordat u begint.

• Een IoT-hub. Als u geen hub hebt, kunt u de stappen volgen om een IoT-hub te maken.

• Azure PowerShell. Als u Azure PowerShell lokaal wilt gebruiken, installeert u de Azure PowerShell-module op uw computer. Als u Azure PowerShell in een webbrowser wilt gebruiken, schakelt u Azure Cloud Shell in.

• Een Azure Storage-resource. Zie Een opslagaccount maken als u een nieuw Azure Storage-account wilt maken.

• (Aanbevolen) Een beheerde identiteit met op rollen gebaseerd toegangsbeheermachtigingen voor het opslagaccount. Zie Een Azure-rol toewijzen voor toegang tot blobgegevens voor meer informatie.

Eindpunten maken

In IoT Hub kunt u een route maken om berichten te verzenden of gebeurtenissen vast te leggen. Elke route heeft een gegevensbron en een eindpunt. De gegevensbron is waar berichten of gebeurtenislogboeken vandaan komen. Het eindpunt is waar de berichten of gebeurtenislogboeken terechtkomen. U kiest locaties voor de gegevensbron en het eindpunt wanneer u een nieuwe route in uw IoT-hub maakt. Vervolgens gebruikt u routeringsquery's om berichten of gebeurtenissen te filteren voordat ze naar het eindpunt gaan.

De service die u gebruikt om uw eindpunt te maken, moet eerst aanwezig zijn in uw Azure-account.

Notitie

Als u een lokale versie van Azure PowerShell gebruikt, meldt u zich aan bij Azure PowerShell voordat u begint.

Event Hubs

De opdrachten in de volgende procedures gebruiken deze verwijzingen:

• Az.IotHub
• Az.EventHub

1. Haal de primaire verbindingsreeks op uit uw Event Hub. Kopieer de verbindingsreeks om later te gebruiken.

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

2. Maak een nieuw IoT Hub-eindpunt voor Event Hubs. Gebruik uw primaire verbindingsreeks uit de vorige stap. De waarde voor EndpointType moet zijn EventHub. Gebruik voor alle andere parameters de waarden voor uw scenario.

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

   Zie Add-AzIotHubRoutingEndpoint voor alle opties voor routeringseindpunten.

Service Bus-wachtrij

De opdrachten in de volgende procedures gebruiken deze verwijzingen:

• Az.IotHub
• Az.ServiceBus

Ga als volgt te werk om een nieuw Service Bus-wachtrijeindpunt te maken:

1. Haal de primaire verbindingsreeks op uit uw Service Bus-naamruimte. Kopieer de verbindingsreeks om later te gebruiken.

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

2. Maak een nieuw IoT Hub-eindpunt voor uw Service Bus-wachtrij. Gebruik uw primaire verbindingsreeks uit de vorige stap en ;EntityPath=MyServiceBusQueue voeg deze toe aan het einde. De waarde voor EndpointType moet zijn ServiceBusQueue. Gebruik voor alle andere parameters de waarden voor uw scenario. Gebruik EndpointNamehiervoor een unieke waarde.

   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"
   

   Zie Add-AzIotHubRoutingEndpoint voor een lijst met alle opties voor routeringseindpunten.

Service Bus-onderwerp

De opdrachten in de volgende procedures gebruiken deze verwijzingen:

• Az.IotHub
• Az.ServiceBus

1. Haal de primaire verbindingsreeks op uit uw Service Bus-naamruimte. Kopieer de verbindingsreeks om later te gebruiken.

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

2. Maak een nieuw IoT Hub-eindpunt voor uw Service Bus-onderwerp. Gebruik uw primaire verbindingsreeks uit de vorige stap en ;EntityPath=MyServiceBusTopic voeg deze toe aan het einde. De waarde voor EndpointType moet zijn ServiceBusTopic. Gebruik voor alle andere parameters de waarden voor uw scenario. Gebruik EndpointNamehiervoor een unieke waarde.

   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"
   

   Zie Add-AzIotHubRoutingEndpoint voor een lijst met alle opties voor routeringseindpunten.

Azure Storage

De opdrachten in de volgende procedures gebruiken deze verwijzingen:

• Az.IotHub
• Az.Storage

Als u een eindpunt voor Azure Storage wilt maken, hebt u uw toegangssleutel nodig om een verbindingsreeks te maken. De verbindingsreeks maakt vervolgens deel uit van de IoT Hub-opdracht om een eindpunt te maken.

1. Haal uw toegangssleutel op uit uw opslagaccount en kopieer deze vervolgens.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Maak een primaire verbindingsreeks voor uw opslagaccount op basis van de volgende sjabloon. Vervang mystorageaccount (op twee plaatsen) door de naam van uw opslagaccount. Vervang mykey door uw sleutel uit de vorige stap.

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

   Deze verbindingsreeks is vereist in de stap om het eindpunt te maken.

3. Maak uw Azure Storage-eindpunt met de verbindingsreeks die u hebt gemaakt. EndpointType moet de waarde azurestoragehebben. Gebruik voor alle andere parameters de waarden voor uw scenario. Gebruik EndpointNamehiervoor een unieke waarde.

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

4. Wanneer u om de containernaam wordt gevraagd, voert u de containernaam in en selecteert u Enter om het eindpunt te maken.

Een IoT Hub-route maken

Met uw nieuwe eindpunt in uw IoT-hub kunt u een nieuwe route maken.

De standaardbackroute in IoT Hub verzamelt berichten van DeviceMessages. Kies een andere optie voor uw aangepaste route, zoals DeviceConnectionStateEvents. Zie Add-AzIotHubRoute voor meer informatie over bronopties. De Enabled parameter is een schakeloptie, dus u hoeft geen waarde te gebruiken met de parameter.

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

PowerShell geeft een bevestiging weer die lijkt op dit voorbeeld:

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

Een IoT Hub-route bijwerken

Gebruik de volgende opdracht om wijzigingen aan te brengen in een bestaande route. Probeer bijvoorbeeld de naam van uw route te wijzigen met behulp van de opdracht.

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

Gebruik de Get-AzIotHubRoute opdracht om de wijziging in uw route te bevestigen:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Een eindpunt verwijderen

Een eindpunt verwijderen:

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

Een IoT Hub-route verwijderen

Een IoT Hub-route verwijderen:

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

Tip

Als u een route verwijdert, worden er geen eindpunten in uw Azure-account verwijderd. U moet een eindpunt afzonderlijk verwijderen van het verwijderen van een route.

Volgende stappen

In dit artikel hebt u geleerd hoe u een route en eindpunt maakt voor Event Hubs, Service Bus-wachtrijen en onderwerpen en Azure Storage.

Zie zelfstudie: Apparaatgegevens verzenden naar Azure Storage met behulp van IoT Hub-berichtroutering voor meer informatie over berichtroutering. In de zelfstudie maakt u een opslagroute en test u deze met een apparaat in uw IoT-hub.