Udostępnij za pośrednictwem

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.

Uwaga

Obecnie program PowerShell nie obsługuje typów uwierzytelniania tożsamości zarządzanych na potrzeby tworzenia punktów końcowych. Jeśli nie możesz użyć uwierzytelniania SAS w swoim scenariuszu, użyj jednego z innych narzędzi do zarządzania, aby utworzyć punkty końcowe.

Ponadto program PowerShell obecnie nie obsługuje tworzenia punktów końcowych usługi Cosmos DB.

Wymagania wstępne

Zapoznaj się z wymaganiami wstępnymi dotyczącymi tego artykułu na podstawie typu punktu końcowego, do którego chcesz kierować komunikaty.

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

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ń:

  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.