Routes en eindpunten maken en verwijderen met behulp van Azure PowerShell

In dit artikel wordt beschreven 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 om routes en eindpunten te maken voor Azure Event Hubs, Azure Service Bus wachtrijen en onderwerpen, en Azure Storage.

Zie Use IoT Hub message routing to send device-to-cloud messages to different endpoints (IoT Hub berichtroutering gebruiken om apparaat-naar-cloud-berichten naar verschillende eindpunten te verzenden) voor meer informatie over de werking van routering in IoT Hub. Zie Zelfstudie: Apparaatgegevens verzenden naar Azure Storage met behulp van IoT Hub berichtroutering voor informatie over het instellen van een route waarmee berichten naar de opslag worden verzonden en vervolgens testen op een gesimuleerd apparaat.

Vereisten

Voor de procedures die in het artikel worden beschreven, worden de volgende resources gebruikt:

• Azure PowerShell
• Een IoT-hub
• Een eindpuntservice in Azure

Azure PowerShell

In dit artikel worden Azure PowerShell gebruikt om te werken met IoT Hub en andere Azure-services. Als u Azure PowerShell lokaal wilt gebruiken, installeert u de module Azure PowerShell op uw computer. Als u Azure PowerShell in een webbrowser wilt gebruiken, schakelt u Azure Cloud Shell in.

IoT-hub

Als u een IoT-hubroute wilt maken, hebt u een IoT-hub nodig die u hebt gemaakt met behulp van Azure IoT Hub. Apparaatberichten en gebeurtenislogboeken zijn afkomstig van uw IoT-hub.

Zorg ervoor dat u de volgende hubresource gebruikt wanneer u uw IoT-hubroute maakt:

• Een IoT-hub in uw Azure-abonnement. Als u nog geen hub hebt, kunt u de stappen volgen om een IoT-hub te maken met behulp van de powershell-cmdlet New-AzIotHub.

Eindpuntservice

Als u een IoT-hubroute wilt maken, moet u ten minste één andere Azure-service gebruiken als eindpunt voor de route. Het eindpunt ontvangt apparaatberichten en gebeurtenislogboeken. U kunt kiezen welke Azure-service u gebruikt voor een eindpunt om verbinding te maken met uw IoT-hubroute: Event Hubs, Service Bus-wachtrijen of -onderwerpen, of Azure Storage.

Zorg ervoor dat u een van de volgende resources hebt om te gebruiken wanneer u een eindpunt maakt voor uw IoT-hubroute:

• Een Event Hubs-resource (met container). Als u een nieuwe Event Hubs-resource wilt maken, raadpleegt u Quickstart: Een Event Hub maken met behulp van Azure PowerShell.

• Een Service Bus-wachtrijresource. Als u een nieuwe Service Bus-wachtrij wilt maken, raadpleegt u Azure PowerShell gebruiken om een Service Bus-naamruimte en -wachtrij te maken.

• Een Service Bus-onderwerpresource. Als u een nieuw Service Bus-onderwerp wilt maken, raadpleegt u de naslaginformatie New-AzServiceBusTopic en de documentatie voor Azure Service Bus messaging.

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

Resources en 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 maakt in uw IoT-hub. Vervolgens gebruikt u routeringsquery's om berichten of gebeurtenissen te filteren voordat ze naar het eindpunt gaan.

U kunt een Event Hub, een Service Bus-wachtrij of -onderwerp of een opslagaccount gebruiken als eindpunt voor uw IoT-hubroute. De service die u gebruikt om uw eindpunt te maken, moet eerst in uw Azure-account bestaan.

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

Een Event Hub maken

Een nieuwe Event Hubs-resource maken met een autorisatieregel:

1. Maak een nieuwe Event Hubs-naamruimte. Gebruik NamespaceNamevoor een unieke waarde.

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

2. Maak uw nieuwe Event Hubs-entiteit. Gebruik Namevoor een unieke waarde. Voor NamespaceNamegebruikt u de naam van de naamruimte die u in de vorige stap hebt gemaakt.

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

3. Maak een nieuwe autorisatieregel. Gebruik voor Namede naam van uw entiteit voor EventHubName. Gebruik een unieke waarde voor de naam van uw autorisatieregel.

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

   Zie Toegang tot Azure Event Hubs autoriseren voor meer informatie over toegang.

Een Event Hubs-eindpunt maken

1. Haal de primaire connection string op uit uw Event Hub. Kopieer de connection string voor later gebruik.

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

2. Maak een nieuw IoT-hub-eindpunt voor Event Hubs. Gebruik uw primaire connection string 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

Een Service Bus-naamruimte en -wachtrij maken

Een nieuwe Service Bus-wachtrijresource maken:

1. Maak een nieuwe Service Bus-naamruimte. Gebruik Namevoor een unieke waarde.

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

2. Maak een nieuwe Service Bus-wachtrij. Voor NamespaceNamegebruikt u de naam van de naamruimte die u in de vorige stap hebt gemaakt. Gebruik een unieke waarde voor de naam van uw wachtrij.

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

Een Service Bus-wachtrijeindpunt maken

Een nieuw Service Bus-wachtrijeindpunt maken:

1. Haal de primaire connection string op uit uw Service Bus-naamruimte. Kopieer de connection string voor later gebruik.

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

2. Maak een nieuw IoT Hub-eindpunt voor uw Service Bus-wachtrij. Gebruik uw primaire connection string uit de vorige stap met ;EntityPath=MyServiceBusQueue toegevoegd aan het einde. De waarde voor EndpointType moet zijn ServiceBusQueue. Gebruik voor alle andere parameters de waarden voor uw scenario. Gebruik EndpointNamevoor 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

Met Service Bus-onderwerpen kunnen gebruikers zich abonneren op een of meer onderwerpen. Als u een onderwerp wilt maken, maakt u ook een Service Bus-naamruimte en -abonnement.

Een Service Bus-naamruimte, -onderwerp en -abonnement maken

1. Maak een nieuwe Service Bus-naamruimte. Gebruik Name voor uw naamruimte een unieke waarde.

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

2. Maak een nieuw Service Bus-onderwerp. Gebruik een unieke waarde voor de onderwerpnaam.

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

3. Maak een nieuw abonnement op uw onderwerp. Gebruik voor TopicNamede naam van het onderwerp dat u in de vorige stap hebt gemaakt. Gebruik een unieke waarde voor uw abonnementsnaam.

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

Een Service Bus-onderwerpeindpunt maken

1. Haal de primaire connection string op uit uw Service Bus-naamruimte. Kopieer de connection string voor later gebruik.

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

2. Maak een nieuw IoT Hub-eindpunt voor uw Service Bus-onderwerp. Gebruik uw primaire connection string uit de vorige stap met ;EntityPath=MyServiceBusTopic toegevoegd aan het einde. De waarde voor EndpointType moet zijn ServiceBusTopic. Gebruik voor alle andere parameters de waarden voor uw scenario. Gebruik EndpointNamevoor 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 Azure Storage-eindpunt en -route wilt maken, hebt u een opslagaccount en -container nodig.

Een Azure Storage-account en -container maken

1. Maak een nieuw Azure Storage-account. De waarde van Name voor uw opslagaccount mag alleen kleine letters en cijfers bevatten. Zie SkuNameSkuName voor opties.

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

2. Maak een nieuwe container in uw opslagaccount. U moet een context maken voor uw opslagaccount in een variabele en vervolgens de variabele toevoegen aan de Context parameter. Zie Blobcontainers beheren met Behulp van PowerShell voor meer informatie over uw opties bij het maken van een container. Gebruik Namevoor een unieke waarde voor de naam van uw container.

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

Een Azure Storage-eindpunt maken

Als u een eindpunt voor Azure Storage wilt maken, hebt u uw toegangssleutel nodig om een connection string te maken. De connection string maakt vervolgens deel uit van de opdracht IoT Hub 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 connection string voor uw opslagaccount op basis van de volgende sjabloon. Vervang mystorageaccount (op twee plaatsen) door de naam van uw opslagaccount. Vervang door mykey uw sleutel uit de vorige stap.

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

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

3. Maak uw Azure Storage-eindpunt met de connection string die u hebt gemaakt. EndpointType moet de waarde azurestoragehebben. Gebruik voor alle andere parameters de waarden voor uw scenario. Gebruik EndpointNamevoor 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 standaardroute voor terugval 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, zodat u geen waarde met de parameter hoeft te gebruiken.

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