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.

Požadavky

Postupy popsané v článku používají následující zdroje informací:

  • Azure PowerShell
  • Služba IoT Hub
  • Služba koncového bodu v Azure

Azure PowerShell

Tento článek používá Azure PowerShell k práci se službou IoT Hub a dalšími službami Azure. Pokud chcete azure PowerShell používat místně, nainstalujte do počítače modul Azure PowerShell. Pokud chcete azure PowerShell použít ve webovém prohlížeči, povolte Azure Cloud Shell.

IoT hub

Pokud chcete vytvořit trasu centra IoT, potřebujete centrum IoT, které jste vytvořili pomocí Azure IoT Hubu. Zprávy zařízení a protokoly událostí pocházejí z vašeho centra IoT.

Při vytváření trasy ioT Hubu nezapomeňte použít následující prostředek centra:

  • Centrum Azure IoT. Pokud nemáte centrum IoT, můžete ho vytvořit pomocí rutiny New-AzIoTHub nebo postupovat podle pokynů v tématu Vytvoření centra IoT.

Služba koncových bodů

Pokud chcete vytvořit trasu centra IoT, potřebujete alespoň jednu jinou službu Azure, která se má použít jako koncový bod pro trasu. Koncový bod přijímá zprávy zařízení a protokoly událostí. Můžete zvolit, kterou službu Azure použijete pro koncový bod pro připojení ke směrování centra IoT: Event Hubs, fronty služby Service Bus nebo témata nebo Azure Storage.

Při vytváření koncového bodu trasy ioT Hubu nezapomeňte použít jeden z následujících prostředků:

Vytváření prostředků a 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.

Centrum událostí, frontu nebo téma služby Service Bus nebo účet úložiště můžete použít jako koncový bod pro trasu centra IoT. 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:

Vytvoření centra událostí

Vytvoření nového prostředku služby Event Hubs s autorizačním pravidlem:

  1. Vytvořte nový obor názvů služby Event Hubs. Pro NamespaceNamepoužití jedinečné hodnoty.

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

  2. Vytvořte novou entitu Event Hubs. Pro Namepoužití jedinečné hodnoty. Použijte NamespaceNamenázev oboru názvů, který jste vytvořili v předchozím kroku.

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

  3. Vytvořte nové autorizační pravidlo. Pro Namepoužití názvu entity pro EventHubName. Jako název autorizačního pravidla použijte jedinečnou hodnotu.

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

    Další informace o přístupu najdete v tématu Autorizace přístupu ke službě Azure Event Hubs.

Vytvoření koncového bodu služby Event Hubs

  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.