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

  • Artykuł

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

Aby dowiedzieć się więcej o sposobie działania routingu w usłudze IoT Hub, zobacz Używanie routingu komunikatów usługi IoT Hub w celu wysyłania komunikatów z urządzenia do chmury do różnych punktów końcowych. Aby zapoznać się z konfigurowaniem trasy, która wysyła komunikaty do magazynu, a następnie testowania na urządzeniu symulowanym, zobacz Samouczek: wysyłanie danych urządzenia do usługi Azure Storage przy użyciu routingu komunikatów usługi 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 programu Azure PowerShell do pracy z usługą IoT Hub i innymi usługami platformy Azure. Aby użyć programu Azure PowerShell lokalnie, zainstaluj moduł Azure PowerShell na komputerze. Alternatywnie, aby użyć programu Azure PowerShell w przeglądarce internetowej, włącz usługę Azure Cloud Shell.

Centrum IoT

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

Pamiętaj, aby podczas tworzenia trasy centrum IoT Hub używać następującego zasobu:

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ądzenia i dzienniki zdarzeń. Możesz wybrać usługę platformy Azure używaną dla punktu końcowego do nawiązania połączenia z trasą centrum IoT: Event Hubs, Kolejki lub tematy usługi Service Bus lub Azure Storage.

Upewnij się, że podczas tworzenia punktu końcowego trasy centrum IoT hub należy użyć jednego z następujących zasobów:

Tworzenie zasobów i punktów końcowych

W usłudze IoT Hub możesz 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 kończą się komunikaty lub dzienniki zdarzeń. Lokalizacje źródła danych i punktu końcowego są wybierane podczas tworzenia nowej trasy w centrum IoT. Następnie użyjesz zapytań routingu 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 programu Azure PowerShell, przed rozpoczęciem zaloguj się do programu Azure PowerShell .

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

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 polu NamespaceNameuż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 elementu EventHubName. 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 usługi Azure Event Hubs.

Tworzenie punktu końcowego usługi Event Hubs

  1. Pobierz parametry połączenia podstawową z centrum zdarzeń. Skopiuj parametry połączenia do późniejszego użycia.

    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 parametry połączenia podstawowej z poprzedniego kroku. Wartość parametru EndpointType musi mieć wartość EventHub. Dla wszystkich innych 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.

Tworzenie trasy usługi IoT Hub

Za pomocą nowego punktu końcowego w centrum IoT możesz utworzyć nową trasę.

Domyślna trasa rezerwowa w usłudze IoT Hub zbiera komunikaty z DeviceMessagesusługi . Wybierz inną opcję dla trasy niestandardowej, na przykład DeviceConnectionStateEvents. Aby uzyskać więcej informacji na temat opcji źródła, 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 usługi IoT Hub

Aby wprowadzić zmiany w istniejącej trasie, użyj następującego polecenia. Na przykład spróbuj 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 usługi IoT Hub

Aby usunąć trasę usługi IoT Hub:

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

Napiwek

Usunięcie trasy nie powoduje usunięcia żadnych punktów końcowych na koncie platformy Azure. Musisz usunąć punkt końcowy oddzielnie od usunięcia 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 usługi IoT Hub. W tym samouczku utworzysz trasę magazynu i przetestujesz ją za pomocą urządzenia w centrum IoT.