Skapa och ta bort vägar och slutpunkter med hjälp av Azure PowerShell

Den här artikeln visar hur du skapar en väg och en slutpunkt i hubben i Azure IoT Hub och sedan tar bort din väg och slutpunkt. Lär dig hur du använder Azure PowerShell för att skapa vägar och slutpunkter för Azure Event Hubs, Azure Service Bus köer och ämnen samt Azure Storage.

Mer information om hur routning fungerar i IoT Hub finns i Använda IoT Hub meddelanderoutning för att skicka meddelanden från enhet till moln till olika slutpunkter. Information om hur du konfigurerar en väg som skickar meddelanden till lagring och sedan testar på en simulerad enhet finns i Självstudie: Skicka enhetsdata till Azure Storage med hjälp av IoT Hub meddelanderoutning.

Förutsättningar

De procedurer som beskrivs i artikeln använder följande resurser:

• Azure PowerShell
• En IoT Hub
• En slutpunktstjänst i Azure

Azure PowerShell

Den här artikeln använder Azure PowerShell för att arbeta med IoT Hub och andra Azure-tjänster. Om du vill använda Azure PowerShell lokalt installerar du modulen Azure PowerShell på datorn. Du kan också aktivera Azure Cloud Shell om du vill använda Azure PowerShell i en webbläsare.

IoT-hubb

För att skapa en IoT Hub-väg behöver du en IoT-hubb som du skapade med hjälp av Azure IoT Hub. Enhetsmeddelanden och händelseloggar kommer från din IoT-hubb.

Se till att ha följande hubbresurs att använda när du skapar din IoT Hub-väg:

• En IoT-hubb i din Azure-prenumeration. Om du inte har någon hubb ännu kan du följa stegen för att skapa en IoT-hubb med hjälp av New-AzIotHub PowerShell-cmdlet.

Slutpunktstjänst

För att skapa en IoT-hubbväg behöver du minst en annan Azure-tjänst som ska användas som slutpunkt för vägen. Slutpunkten tar emot enhetsmeddelanden och händelseloggar. Du kan välja vilken Azure-tjänst du använder för en slutpunkt för att ansluta till din IoT-hubbväg: Event Hubs, Service Bus-köer eller ämnen eller Azure Storage.

Se till att ha någon av följande resurser att använda när du skapar en slutpunkt för din IoT Hub-väg:

• En Event Hubs-resurs (med container). Om du behöver skapa en ny Event Hubs-resurs läser du Snabbstart: Skapa en händelsehubb med hjälp av Azure PowerShell.

• En Service Bus-köresurs. Om du behöver skapa en ny Service Bus-kö kan du läsa Använda Azure PowerShell för att skapa ett Service Bus-namnområde och en kö.

• En Service Bus-ämnesresurs. Om du behöver skapa ett nytt Service Bus-ämne läser du referensen New-AzServiceBusTopic och Azure Service Bus meddelandedokumentation.

• En Azure Storage-resurs. Om du behöver skapa ett nytt lagringskonto i Azure läser du Skapa ett lagringskonto.

Skapa resurser och slutpunkter

I IoT Hub kan du skapa en väg för att skicka meddelanden eller avbilda händelser. Varje väg har en datakälla och en slutpunkt. Datakällan är den där meddelanden eller händelseloggar kommer från. Slutpunkten är där meddelandena eller händelseloggarna hamnar. Du väljer platser för datakällan och slutpunkten när du skapar en ny väg i din IoT-hubb. Sedan använder du routningsfrågor för att filtrera meddelanden eller händelser innan de går till slutpunkten.

Du kan använda en händelsehubb, en Service Bus-kö eller ett ämne eller ett lagringskonto för att vara slutpunkten för din IoT Hub-väg. Den tjänst som du använder för att skapa slutpunkten måste först finnas i ditt Azure-konto.

Anteckning

Om du använder en lokal version av Azure PowerShell loggar du in på Azure PowerShell innan du börjar.

Event Hubs

Kommandona i följande procedurer använder följande referenser:

• Az.IotHub
• Az.EventHub

Skapa en händelsehubb

Så här skapar du en ny Event Hubs-resurs som har en auktoriseringsregel:

1. Skapa ett nytt Event Hubs-namnområde. För NamespaceNameanvänder du ett unikt värde.

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

2. Skapa din nya Event Hubs-entitet. För Nameanvänder du ett unikt värde. För NamespaceNameanvänder du namnet på namnområdet som du skapade i föregående steg.

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

3. Skapa en ny auktoriseringsregel. För Nameanvänder du namnet på din entitet för EventHubName. Använd ett unikt värde för namnet på auktoriseringsregeln.

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

   Mer information om åtkomst finns i Auktorisera åtkomst till Azure Event Hubs.

Skapa en Event Hubs-slutpunkt

1. Hämta den primära anslutningssträngen från din händelsehubb. Kopiera anslutningssträngen som ska användas senare.

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

2. Skapa en ny IoT Hub-slutpunkt till Event Hubs. Använd din primära anslutningssträng från föregående steg. Värdet för EndpointType måste vara EventHub. Använd värdena för ditt scenario för alla andra parametrar.

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

   Om du vill se alla alternativ för routningsslutpunkter kan du läsa Add-AzIotHubRoutingEndpoint.

Service Bus-kö

Kommandona i följande procedurer använder följande referenser:

• Az.IotHub
• Az.ServiceBus

Skapa ett Service Bus-namnområde och en kö

Så här skapar du en ny Service Bus-köresurs :

1. Skapa ett nytt Service Bus-namnområde. För Nameanvänder du ett unikt värde.

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

2. Skapa en ny Service Bus-kö. För NamespaceNameanvänder du namnet på namnområdet som du skapade i föregående steg. Använd ett unikt värde för namnet på kön.

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

Skapa en Service Bus-köslutpunkt

Så här skapar du en ny Service Bus-köslutpunkt:

1. Hämta den primära anslutningssträngen från Service Bus-namnområdet. Kopiera anslutningssträngen som ska användas senare.

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

2. Skapa en ny IoT Hub-slutpunkt i Service Bus-kön. Använd din primära anslutningssträng från föregående steg med ;EntityPath=MyServiceBusQueue tillagd i slutet. Värdet för EndpointType måste vara ServiceBusQueue. Använd värdena för ditt scenario för alla andra parametrar. För EndpointNameanvänder du ett unikt värde.

   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"
   

   En lista över alla alternativ för routningsslutpunkter finns i Add-AzIotHubRoutingEndpoint.

Service Bus-ämne

Kommandona i följande procedurer använder följande referenser:

• Az.IotHub
• Az.ServiceBus

Med Service Bus-ämnen kan användarna prenumerera på ett eller flera ämnen. Om du vill skapa ett ämne skapar du även ett Service Bus-namnområde och en prenumeration.

Skapa ett Service Bus-namnområde, ett ämne och en prenumeration

1. Skapa ett nytt Service Bus-namnområde. Använd Name ett unikt värde för ditt namnområde.

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

2. Skapa ett nytt Service Bus-ämne. Använd ett unikt värde som ämnesnamn.

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

3. Skapa en ny prenumeration på ditt ämne. För TopicNameanvänder du namnet på det ämne som du skapade i föregående steg. Använd ett unikt värde som prenumerationsnamn.

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

Skapa en Service Bus-ämnesslutpunkt

1. Hämta den primära anslutningssträngen från Service Bus-namnområdet. Kopiera anslutningssträngen för senare användning.

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

2. Skapa en ny IoT Hub-slutpunkt till ditt Service Bus-ämne. Använd din primära anslutningssträng från föregående steg med ;EntityPath=MyServiceBusTopic tillagd i slutet. Värdet för EndpointType måste vara ServiceBusTopic. För alla andra parametrar använder du värdena för ditt scenario. För EndpointNameanvänder du ett unikt värde.

   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"
   

   En lista över alla alternativ för routningsslutpunkter finns i Add-AzIotHubRoutingEndpoint.

Azure Storage

Kommandona i följande procedurer använder följande referenser:

• Az.IotHub
• Az.Storage

Om du vill skapa en Azure Storage-slutpunkt och -väg behöver du ett lagringskonto och en container.

Skapa ett Azure Storage-konto och en container

1. Skapa ett nytt Azure Storage-konto. Värdet Name för för ditt lagringskonto får bara innehålla gemener och siffror. Alternativ finns SkuNamei SkuName.

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

2. Skapa en ny container i ditt lagringskonto. Du måste skapa en kontext till ditt lagringskonto i en variabel och sedan lägga till variabeln i parametern Context . Mer information om dina alternativ när du skapar en container finns i Hantera blobcontainrar med hjälp av PowerShell. För Nameanvänder du ett unikt värde för namnet på containern.

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

Skapa en Azure Storage-slutpunkt

Om du vill skapa en slutpunkt till Azure Storage behöver du din åtkomstnyckel för att skapa en anslutningssträng. Anslutningssträngen är sedan en del av kommandot IoT Hub för att skapa en slutpunkt.

1. Hämta din åtkomstnyckel från ditt lagringskonto och kopiera den sedan.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Skapa en primär anslutningssträng för ditt lagringskonto baserat på följande mall. Ersätt mystorageaccount (på två ställen) med namnet på ditt lagringskonto. Ersätt mykey med nyckeln från föregående steg.

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

   Den här anslutningssträngen krävs i steget för att skapa slutpunkten.

3. Skapa din Azure Storage-slutpunkt med anslutningssträngen som du skapade. EndpointType måste ha värdet azurestorage. För alla andra parametrar använder du värdena för ditt scenario. För EndpointNameanvänder du ett unikt värde.

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

4. När du uppmanas att ange ditt containernamn anger du containernamnet och väljer sedan Retur för att skapa slutpunkten.

Skapa en IoT Hub väg

Med din nya slutpunkt i IoT-hubben kan du skapa en ny väg.

Standardåterställningsvägen i IoT Hub samlar in meddelanden från DeviceMessages. Välj ett annat alternativ för din anpassade väg, till exempel DeviceConnectionStateEvents. Mer information om källalternativ finns i Add-AzIotHubRoute. Parametern Enabled är en växel, så du behöver inte använda ett värde med parametern .

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

PowerShell visar en bekräftelse som liknar det här exemplet:

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

Uppdatera en IoT Hub väg

Om du vill göra ändringar i en befintlig väg använder du följande kommando. Prova till exempel att ändra namnet på din väg med hjälp av kommandot .

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

Get-AzIotHubRoute Använd kommandot för att bekräfta ändringen i din väg:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Ta bort en slutpunkt

Så här tar du bort en slutpunkt:

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

Ta bort en IoT Hub väg

Så här tar du bort en IoT Hub väg:

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

Tips

Om du tar bort en väg tas inga slutpunkter bort i ditt Azure-konto. Du måste ta bort en slutpunkt separat från att ta bort en väg.

Nästa steg

I den här instruktioner-artikeln har du lärt dig hur du skapar en väg och slutpunkt för Event Hubs, Service Bus-köer och -ämnen samt Azure Storage.

Mer information om meddelanderoutning finns i Självstudie: Skicka enhetsdata till Azure Storage med hjälp av IoT Hub meddelanderoutning. I självstudien skapar du en lagringsväg och testar den med en enhet i din IoT-hubb.