Sdílet prostřednictvím

Vytváření a odstraňování tras a koncových bodů pomocí Azure PowerShellu

  • Článek

V tomto článku se dozvíte, jak vytvořit trasu a koncový bod v centru v Azure IoT Hubu a pak odstranit trasu a koncový bod. Naučte se používat Azure PowerShell k vytváření tras a koncových bodů pro službu Azure Event Hubs, fronty a témata služby Azure Service Bus a Azure Storage.

Další informace o tom, jak směrování funguje ve službě IoT Hub, najdete v tématu Použití směrování zpráv služby IoT Hub k odesílání zpráv typu zařízení-cloud do různých koncových bodů. Pokud chcete projít nastavením trasy, která odesílá zprávy do úložiště a pak testuje simulované zařízení, přečtěte si kurz : Odeslání dat zařízení do služby Azure Storage pomocí směrování zpráv ioT Hubu.

Poznámka:

PowerShell v současné době nepodporuje typy ověřování spravovaných identit pro vytváření koncových bodů. Pokud ve svém scénáři nemůžete použít ověřování SAS, vytvořte koncové body pomocí některého z dalších nástrojů pro správu.

PowerShell také v současné době nepodporuje vytváření koncových bodů Cosmos DB.

Požadavky

Projděte si požadavky tohoto článku na základě typu koncového bodu, do kterého chcete zprávy směrovat.

Vytváření koncových bodů

Ve službě IoT Hub můžete vytvořit trasu pro odesílání zpráv nebo zachytávání událostí. Každá trasa má zdroj dat a koncový bod. Zdrojem dat jsou zprávy nebo protokoly událostí. Koncový bod je místo, kde končí zprávy nebo protokoly událostí. Při vytváření nové trasy ve službě IoT Hub zvolíte umístění pro zdroj dat a koncový bod. Potom pomocí směrovacích dotazů vyfiltrujete zprávy nebo události, než přejdou do koncového bodu.

Služba, kterou používáte k vytvoření koncového bodu, musí nejprve existovat ve vašem účtu Azure.

Poznámka:

Pokud používáte místní verzi Azure PowerShellu, přihlaste se k Azure PowerShellu , než začnete.

Příkazy v následujících postupech používají tyto odkazy:

  1. Získejte primární připojovací řetězec z centra událostí. Zkopírujte připojovací řetězec pro pozdější použití.

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

  2. Vytvořte nový koncový bod centra IoT pro Službu Event Hubs. Použijte primární připojovací řetězec z předchozího kroku. Hodnota musí EndpointType být EventHub. Pro všechny ostatní parametry použijte hodnoty pro váš scénář.

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

    Pokud chcete zobrazit všechny možnosti koncového bodu směrování, přečtěte si téma Add-AzIotHubRoutingEndpoint.

Vytvoření trasy IoT Hubu

S novým koncovým bodem ve službě IoT Hub můžete vytvořit novou trasu.

Výchozí náhradní trasa ve službě IoT Hub shromažďuje zprávy z DeviceMessages. Zvolte jinou možnost pro vlastní trasu, například DeviceConnectionStateEvents. Další informace o možnostech zdroje najdete v tématu Add-AzIotHubRoute. Parametr Enabled je přepínač, takže u parametru nemusíte používat hodnotu.

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

PowerShell zobrazí potvrzení, které vypadá podobně jako v tomto příkladu:

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

Aktualizace trasy IoT Hubu

Pokud chcete provést změny existující trasy, použijte následující příkaz. Zkuste například změnit název trasy pomocí příkazu.

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

Get-AzIotHubRoute Pomocí příkazu potvrďte změnu ve vaší trase:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Odstranění koncového bodu

Odstranění koncového bodu:

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

Odstranění trasy IoT Hubu

Odstranění trasy IoT Hubu:

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

Tip

Odstranění trasy neodstraní žádné koncové body ve vašem účtu Azure. Koncový bod musíte odstranit odděleně od odstranění trasy.

Další kroky

V tomto článku s postupy jste zjistili, jak vytvořit trasu a koncový bod pro službu Event Hubs, fronty a témata služby Service Bus a Azure Storage.

Další informace o směrování zpráv najdete v tématu Kurz: Odesílání dat zařízení do služby Azure Storage pomocí směrování zpráv ioT Hubu. V tomto kurzu vytvoříte trasu úložiště a otestujete ji pomocí zařízení ve službě IoT Hub.