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 slutpunkt i din hubb 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.

Kommentar

PowerShell stöder för närvarande inte autentiseringstyper för hanterade identiteter för att skapa slutpunkter. Om du inte kan använda SAS-autentisering i ditt scenario använder du något av de andra hanteringsverktygen för att skapa slutpunkter.

PowerShell stöder för närvarande inte heller att skapa Cosmos DB-slutpunkter.

Förutsättningar

Granska förutsättningarna för den här artikeln baserat på vilken typ av slutpunkt du vill dirigera meddelandena till.

Event Hubs

• En Azure-prenumeration Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto innan du börjar.

• En IoT-hubb. Om du inte har någon hubb kan du följa stegen för att skapa en IoT-hubb.

• Azure PowerShell. Om du vill använda Azure PowerShell lokalt installerar du Azure PowerShell-modulen på datorn. Du kan också aktivera Azure Cloud Shell om du vill använda Azure PowerShell i en webbläsare.

• En Event Hubs-resurs (med container). Om du behöver skapa en ny Event Hubs-resurs kan du läsa Snabbstart: Skapa en händelsehubb.

• (Rekommenderas) En hanterad identitet med rollbaserad åtkomstkontrollbehörighet för Event Hubs-namnområdet. Mer information finns i Autentisera en hanterad identitet med Microsoft Entra-ID för åtkomst till Event Hubs-resurser.

Service Bus-kö

• En Azure-prenumeration Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto innan du börjar.

• En IoT-hubb. Om du inte har någon hubb kan du följa stegen för att skapa en IoT-hubb.

• Azure PowerShell. Om du vill använda Azure PowerShell lokalt installerar du Azure PowerShell-modulen på datorn. Du kan också aktivera Azure Cloud Shell om du vill använda Azure PowerShell i en webbläsare.

• En Service Bus-köresurs. Om du behöver skapa en ny Service Bus-kö kan du läsa Snabbstart: Skapa ett Service Bus-namnområde och en kö.

• (Rekommenderas) En hanterad identitet med rollbaserade åtkomstkontrollbehörigheter för Service Bus-namnområdet eller kön. Mer information finns i Autentisera en hanterad identitet med Microsoft Entra-ID för åtkomst till Azure Service Bus-resurser

Service Bus-ämne

• En Azure-prenumeration Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto innan du börjar.

• En IoT-hubb. Om du inte har någon hubb kan du följa stegen för att skapa en IoT-hubb.

• Azure PowerShell. Om du vill använda Azure PowerShell lokalt installerar du Azure PowerShell-modulen på datorn. Du kan också aktivera Azure Cloud Shell om du vill använda Azure PowerShell i en webbläsare.

• En Service Bus-ämnesresurs. Om du behöver skapa ett nytt Service Bus-ämne kan du läsa Snabbstart: Skapa ett Service Bus-namnområde med ämne och prenumeration med hjälp av en Resource Manager-mall.

• (Rekommenderas) En hanterad identitet med rollbaserade åtkomstkontrollbehörigheter för Service Bus-namnområdet eller ämnet. Mer information finns i Autentisera en hanterad identitet med Microsoft Entra-ID för åtkomst till Azure Service Bus-resurser

Azure Storage

• En Azure-prenumeration Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto innan du börjar.

• En IoT-hubb. Om du inte har någon hubb kan du följa stegen för att skapa en IoT-hubb.

• Azure PowerShell. Om du vill använda Azure PowerShell lokalt installerar du Azure PowerShell-modulen på datorn. Du kan också aktivera Azure Cloud Shell om du vill använda Azure PowerShell i en webbläsare.

• En Azure Storage-resurs. Om du behöver skapa ett nytt Azure Storage-konto kan du läsa Skapa ett lagringskonto.

• (Rekommenderas) En hanterad identitet med rollbaserad åtkomstkontrollbehörighet för lagringskontot. Mer information finns i Tilldela en Azure-roll för åtkomst till blobdata.

Skapa slutpunkter

I IoT Hub kan du skapa en väg för att skicka meddelanden eller samla in 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.

Den tjänst som du använder för att skapa slutpunkten måste först finnas i ditt Azure-konto.

Kommentar

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

1. Hämta den primära anslutningssträng från händelsehubben. Kopiera anslutningssträng 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>"
   

   Information om hur du ser alla alternativ för routningsslutpunkter finns i Add-AzIotHubRoutingEndpoint.

Service Bus-kö

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

• Az.IotHub
• Az.ServiceBus

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

1. Hämta den primära anslutningssträng från Service Bus-namnområdet. Kopiera anslutningssträng 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 tillagt 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

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

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

2. Skapa en ny IoT-hubbslutpunkt till ditt Service Bus-ämne. Använd din primära anslutningssträng från föregående steg med ;EntityPath=MyServiceBusTopic tillagt i slutet. Värdet för EndpointType måste vara ServiceBusTopic. 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 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

För att skapa en slutpunkt till Azure Storage behöver du din åtkomstnyckel för att skapa en anslutningssträng. Anslutningssträng ingår sedan i IoT Hub-kommandot 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å platser) 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äng krävs i steget för att skapa slutpunkten.

3. Skapa din Azure Storage-slutpunkt med den anslutningssträng du skapade. EndpointType måste ha värdet azurestorage. 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 azurestorage -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "my connection string"
   

4. När du uppmanas att ange containernamnet 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

Dricks

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