Tworzenie i usuwanie tras i punktów końcowych przy użyciu Azure PowerShell

W tym artykule pokazano, jak utworzyć trasę i punkt końcowy w centrum w Azure IoT Hub, a następnie usunąć trasę i punkt końcowy. Dowiedz się, jak używać Azure PowerShell do tworzenia tras i punktów końcowych dla Azure Event Hubs, kolejek i tematów Azure Service Bus oraz usługi Azure Storage.

Aby dowiedzieć się więcej na temat sposobu działania routingu w IoT Hub, zobacz Wysyłanie komunikatów z urządzenia do chmury do różnych punktów końcowych przy użyciu routingu komunikatów IoT Hub. Aby zapoznać się z konfigurowaniem trasy wysyłającej komunikaty do magazynu, a następnie testowania na symulowanym urządzeniu, zobacz Samouczek: wysyłanie danych urządzenia do usługi Azure Storage przy użyciu routingu komunikatów IoT Hub.

Wymagania wstępne

Procedury opisane w artykule korzystają z następujących zasobów:

• Azure PowerShell
• Centrum IoT Hub.
• Usługa punktu końcowego na platformie Azure

Azure PowerShell

W tym artykule użyto Azure PowerShell do pracy z IoT Hub i innymi usługami platformy Azure. Aby użyć Azure PowerShell lokalnie, zainstaluj moduł Azure PowerShell na komputerze. Alternatywnie, aby użyć Azure PowerShell w przeglądarce internetowej, włącz usługę Azure Cloud Shell.

Iot

Aby utworzyć trasę centrum IoT Hub, potrzebujesz centrum IoT utworzonego przy użyciu Azure IoT Hub. Komunikaty urządzeń i dzienniki zdarzeń pochodzą z centrum IoT Hub.

Upewnij się, że podczas tworzenia trasy centrum IoT Hub należy użyć następującego zasobu centrum:

• Centrum IoT Hub w ramach subskrypcji platformy Azure. Jeśli nie masz jeszcze centrum, możesz wykonać kroki tworzenia centrum IoT Hub przy użyciu polecenia cmdlet programu New-AzIotHub PowerShell.

Usługa punktu końcowego

Aby utworzyć trasę centrum IoT Hub, musisz użyć co najmniej jednej innej usługi platformy Azure jako punktu końcowego do trasy. Punkt końcowy odbiera komunikaty urządzeń i dzienniki zdarzeń. Możesz wybrać usługę platformy Azure używaną dla punktu końcowego do nawiązywania połączenia z trasą centrum IoT: Event Hubs, kolejki lub tematy usługi Service Bus lub Azure Storage.

Pamiętaj, aby użyć jednego z następujących zasobów podczas tworzenia punktu końcowego trasy centrum IoT:

• Zasób usługi Event Hubs (z kontenerem). Jeśli musisz utworzyć nowy zasób usługi Event Hubs, zobacz Szybki start: tworzenie centrum zdarzeń przy użyciu Azure PowerShell.

• Zasób kolejki usługi Service Bus. Jeśli musisz utworzyć nową kolejkę usługi Service Bus, zobacz Tworzenie przestrzeni nazw i kolejki usługi Service Bus przy użyciu Azure PowerShell.

• Zasób tematu usługi Service Bus. Jeśli musisz utworzyć nowy temat usługi Service Bus, zapoznaj się z dokumentacją New-AzServiceBusTopic i dokumentacją dotyczącą komunikatów Azure Service Bus.

• Zasób usługi Azure Storage. Jeśli musisz utworzyć nowe konto magazynu na platformie Azure, zobacz Tworzenie konta magazynu.

Tworzenie zasobów i punktów końcowych

W IoT Hub można utworzyć trasę do wysyłania komunikatów lub przechwytywania zdarzeń. Każda trasa ma źródło danych i punkt końcowy. Źródło danych to miejsce, z którego pochodzą komunikaty lub dzienniki zdarzeń. Punkt końcowy to miejsce, w którym są wyświetlane komunikaty lub dzienniki zdarzeń. Lokalizacje dla źródła danych i punktu końcowego są wybierane podczas tworzenia nowej trasy w centrum IoT. Następnie zapytania routingu służą do filtrowania komunikatów lub zdarzeń przed przejściem do punktu końcowego.

Możesz użyć centrum zdarzeń, kolejki lub tematu usługi Service Bus albo konta magazynu jako punktu końcowego dla trasy centrum IoT. Usługa używana do tworzenia punktu końcowego musi najpierw istnieć na koncie platformy Azure.

Uwaga

Jeśli używasz lokalnej wersji Azure PowerShell, przed rozpoczęciem zaloguj się do Azure PowerShell.

Event Hubs

Polecenia w poniższych procedurach korzystają z następujących odwołań:

• Az.IotHub
• Az.EventHub

Tworzenie centrum zdarzeń

Aby utworzyć nowy zasób usługi Event Hubs z regułą autoryzacji:

1. Utwórz nową przestrzeń nazw usługi Event Hubs. W przypadku NamespaceNameelementu użyj unikatowej wartości.

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

2. Utwórz nową jednostkę usługi Event Hubs. W przypadku Nameelementu użyj unikatowej wartości. W przypadku NamespaceNameprogramu użyj nazwy przestrzeni nazw utworzonej w poprzednim kroku.

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

3. Utwórz nową regułę autoryzacji. W przypadku Nameelementu użyj nazwy jednostki dla EventHubNameelementu . Jako nazwę reguły autoryzacji użyj unikatowej wartości.

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

   Aby uzyskać więcej informacji na temat dostępu, zobacz Autoryzowanie dostępu do Azure Event Hubs.

Tworzenie punktu końcowego usługi Event Hubs

1. Pobierz podstawowe parametry połączenia z centrum zdarzeń. Skopiuj parametry połączenia, aby użyć ich później.

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

2. Utwórz nowy punkt końcowy centrum IoT w usłudze Event Hubs. Użyj podstawowych parametrów połączenia z poprzedniego kroku. Wartość parametru EndpointType musi mieć wartość EventHub. Dla wszystkich pozostałych parametrów użyj wartości dla danego scenariusza.

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

   Aby wyświetlić wszystkie opcje punktu końcowego routingu, zobacz Add-AzIotHubRoutingEndpoint.

Kolejka usługi Service Bus

Polecenia w poniższych procedurach korzystają z następujących odwołań:

• Az.IotHub
• Az.ServiceBus

Tworzenie przestrzeni nazw i kolejki usługi Service Bus

Aby utworzyć nowy zasób kolejki usługi Service Bus :

1. Utwórz nową przestrzeń nazw usługi Service Bus. W przypadku Nameelementu użyj unikatowej wartości.

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

2. Utwórz nową kolejkę usługi Service Bus. W przypadku NamespaceNameprogramu użyj nazwy przestrzeni nazw utworzonej w poprzednim kroku. Jako nazwę kolejki użyj unikatowej wartości.

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

Tworzenie punktu końcowego kolejki usługi Service Bus

Aby utworzyć nowy punkt końcowy kolejki usługi Service Bus:

1. Pobierz podstawowe parametry połączenia z przestrzeni nazw usługi Service Bus. Skopiuj parametry połączenia, aby użyć ich później.

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

2. Utwórz nowy punkt końcowy centrum IoT w kolejce usługi Service Bus. Użyj podstawowych parametrów połączenia z poprzedniego kroku z dodanymi ;EntityPath=MyServiceBusQueue do końca. Wartość parametru EndpointType musi mieć wartość ServiceBusQueue. Dla wszystkich pozostałych parametrów użyj wartości dla danego scenariusza. W przypadku EndpointNameelementu użyj unikatowej wartości.

   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"
   

   Aby uzyskać listę wszystkich opcji punktu końcowego routingu, zobacz Add-AzIotHubRoutingEndpoint.

Temat usługi Service Bus

Polecenia w poniższych procedurach korzystają z następujących odwołań:

• Az.IotHub
• Az.ServiceBus

W przypadku tematów usługi Service Bus użytkownicy mogą subskrybować co najmniej jeden temat. Aby utworzyć temat, należy również utworzyć przestrzeń nazw i subskrypcję usługi Service Bus.

Tworzenie przestrzeni nazw, tematu i subskrypcji usługi Service Bus

1. Utwórz nową przestrzeń nazw usługi Service Bus. W przypadku Name przestrzeni nazw użyj unikatowej wartości.

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

2. Utwórz nowy temat usługi Service Bus. Jako nazwę tematu użyj unikatowej wartości.

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

3. Utwórz nową subskrypcję tematu. W przypadku TopicNameprogramu użyj nazwy tematu utworzonego w poprzednim kroku. W przypadku nazwy subskrypcji użyj unikatowej wartości.

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

Tworzenie punktu końcowego tematu usługi Service Bus

1. Pobierz podstawowe parametry połączenia z przestrzeni nazw usługi Service Bus. Skopiuj parametry połączenia do późniejszego użycia.

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

2. Utwórz nowy punkt końcowy centrum IoT w temacie usługi Service Bus. Użyj podstawowych parametrów połączenia z poprzedniego kroku z dodanymi ;EntityPath=MyServiceBusTopic do końca. Wartość musi EndpointType mieć ServiceBusTopicwartość . W przypadku wszystkich innych parametrów użyj wartości dla danego scenariusza. W przypadku EndpointNameprogramu użyj unikatowej wartości.

   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"
   

   Aby uzyskać listę wszystkich opcji punktu końcowego routingu, zobacz Add-AzIotHubRoutingEndpoint.

Azure Storage

Polecenia w poniższych procedurach używają tych odwołań:

• Az.IotHub
• Az.Storage

Aby utworzyć punkt końcowy i trasę usługi Azure Storage, potrzebujesz konta magazynu i kontenera.

Tworzenie konta i kontenera usługi Azure Storage

1. Utwórz nowe konto usługi Azure Storage. Wartość Name konta magazynu może zawierać tylko małe litery i cyfry. Aby uzyskać informacje o SkuName opcjach, zobacz SkuName.

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

2. Utwórz nowy kontener na koncie magazynu. Musisz utworzyć kontekst dla konta magazynu w zmiennej, a następnie dodać zmienną do parametru Context . Aby dowiedzieć się więcej o opcjach podczas tworzenia kontenera, zobacz Zarządzanie kontenerami obiektów blob przy użyciu programu PowerShell. W przypadku Nameelementu użyj unikatowej wartości dla nazwy kontenera.

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

Tworzenie punktu końcowego usługi Azure Storage

Aby utworzyć punkt końcowy w usłudze Azure Storage, musisz utworzyć parametry połączenia za pomocą klucza dostępu. Parametry połączenia są następnie częścią polecenia IoT Hub w celu utworzenia punktu końcowego.

1. Pobierz klucz dostępu z konta magazynu, a następnie skopiuj go.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Skonstruuj podstawowe parametry połączenia dla konta magazynu na podstawie następującego szablonu. Zastąp mystorageaccount (w dwóch miejscach) nazwą konta magazynu. Zastąp mykey ciąg kluczem z poprzedniego kroku.

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

   Te parametry połączenia są wymagane w kroku tworzenia punktu końcowego.

3. Utwórz punkt końcowy usługi Azure Storage przy użyciu utworzonych parametrów połączenia. EndpointType musi mieć wartość azurestorage. W przypadku wszystkich innych parametrów użyj wartości dla danego scenariusza. W przypadku EndpointNameprogramu użyj unikatowej wartości.

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

4. Po wyświetleniu monitu o nazwę kontenera wprowadź nazwę kontenera, a następnie wybierz klawisz Enter, aby utworzyć punkt końcowy.

Tworzenie trasy IoT Hub

Przy użyciu nowego punktu końcowego w centrum IoT możesz utworzyć nową trasę.

Domyślna trasa rezerwowa w IoT Hub zbiera komunikaty z DeviceMessages. Wybierz inną opcję dla trasy niestandardowej, na przykład DeviceConnectionStateEvents. Aby uzyskać więcej informacji na temat opcji źródłowych, zobacz Add-AzIotHubRoute. Parametr Enabled jest przełącznikiem, więc nie trzeba używać wartości z parametrem .

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

Program PowerShell wyświetla potwierdzenie podobne do tego przykładu:

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

Aktualizowanie trasy IoT Hub

Aby wprowadzić zmiany w istniejącej trasie, użyj następującego polecenia. Spróbuj na przykład zmienić nazwę trasy przy użyciu polecenia .

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

Użyj polecenia , Get-AzIotHubRoute aby potwierdzić zmianę trasy:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Usuwanie punktu końcowego

Aby usunąć punkt końcowy:

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

Usuwanie trasy IoT Hub

Aby usunąć trasę IoT Hub:

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

Porada

Usunięcie trasy nie powoduje usunięcia żadnych punktów końcowych na koncie platformy Azure. Punkt końcowy należy usunąć oddzielnie od usuwania trasy.

Następne kroki

W tym artykule z instrukcjami przedstawiono sposób tworzenia trasy i punktu końcowego dla usługi Event Hubs, kolejek i tematów usługi Service Bus oraz usługi Azure Storage.

Aby dowiedzieć się więcej na temat routingu komunikatów, zobacz Samouczek: wysyłanie danych urządzenia do usługi Azure Storage przy użyciu routingu komunikatów IoT Hub. W samouczku utworzysz trasę magazynu i przetestujesz ją za pomocą urządzenia w centrum IoT.