Udostępnij przez

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

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 skonfigurować trasę wysyłającą komunikaty do magazynu, a następnie przetestować to na urządzeniu symulowanym, zapoznaj się z Samouczkiem: wysyłanie danych urządzenia do Azure Storage przy użyciu routingu komunikatów IoT Hub.

Note

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.

Prerequisites

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.

Note

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

  1. Pobierz podstawowe parametry połączenia 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 w centrum IoT dla usługi Event Hubs. Użyj podstawowych parametrów połączenia 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 DeviceMessages. Wybierz inną opcję dla trasy własnej, 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 dla parametru.

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

Tip

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.

Dalsze kroki

W tym artykule instruktażowym omówiono, jak utworzyć trasę i punkt końcowy dla Event Hubs, kolejek i tematów w Service Bus oraz w 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ę przechowywania danych i przetestujesz ją za pomocą urządzenia w centrum węzła IoT.

  • Last updated on