共用方式為


使用 Azure PowerShell 建立和刪除路由與端點

本文說明如何在 Azure IoT 中樞的中樞中建立路由和端點,然後刪除您的路由和端點。 了解如何使用 Azure PowerShell 來建立 Azure 事件中樞、Azure 服務匯流排佇列和主題,以及 Azure 儲存體的路由和端點。

若要深入了解路猶如何在 IoT 中樞運作,請參閱使用 IoT 中樞訊息路由將裝置到雲端的訊息傳送至不同端點。 若要逐步解說如何設定路由以將訊息傳送至儲存體,並在模擬裝置上進行測試,請參閱教學課程: 使用 IoT 中樞訊息路由將裝置資料傳送至 Azure 儲存體

注意

目前,PowerShell 不支援用來建立端點的受控識別驗證類型。 如果您在案例中無法使用 SAS 驗證,請使用其他其中一個管理工具來建立端點。

此外,PowerShell 目前不支援建立 Cosmos DB 端點。

必要條件

根據您要將訊息路由傳送至的端點類型,檢閱本文的必要條件。

建立端點

在 IoT 中樞中,您可以建立路由來傳送訊息或擷取事件。 每個路由都有一個資料來源和端點。 訊息或事件記錄檔源自於資料來源。 端點是訊息或事件記錄檔最後出現的位置。 當您在 IoT 中樞中建立新路由時,您可以選擇資料來源和端點的位置。 接著,您可以在訊息或事件傳送至端點前,使用路由查詢進行篩選。

您用來建立端點的服務必須先存在於 Azure 帳戶中。

注意

如果您使用本機版本的 Azure PowerShell,請在開始之前登入 Azure PowerShell

下列程序中的命令會使用這些參考:

  1. 從事件中樞取得主要連接字串。 複製連接字串以供後續使用。

    Get-AzEventHubKey -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule
    
  2. 將新的 IoT 中樞端點建立至事件中樞。 使用上一個步驟中的主要連接字串。 EndpointType 的值必須是 EventHub。 針對所有其他參數,請使用適用於您案例的值。

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

    若要查看所有路由端點選項,請參閱 Add-AzIotHubRoutingEndpoint

建立 IoT 中樞路由

在 IoT 中樞內使用新的端點,您就可以建立新的路由。

IoT 中樞的預設後援路由會從 DeviceMessages 收集訊息。 為自訂路由選擇不同的選項,例如 DeviceConnectionStateEvents。 如需來源選項的詳細資訊,請參閱 Add-AzIotHubRouteEnabled 參數是參數,因此您不需要搭配參數使用值。

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

PowerShell 會顯示類似於此範例的確認:

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

更新 IoT 中樞路由

若要變更現有的路由,請使用下列命令。 例如,請嘗試使用命令來變更路由的名稱。

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

使用 Get-AzIotHubRoute 命令來確認路由中的變更:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

刪除端點

若要刪除端點:

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

刪除 IoT 中樞路由

若要刪除 IoT 中樞路由:

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

提示

刪除路由並不會刪除 Azure 帳戶中的任何端點。 您必須將刪除端點與刪除路由分開進行。

下一步

在本操作說明文章中,您已了解如何建立事件中樞、服務匯流排佇列和主題,以及 Azure 儲存體的路由和端點。

若要深入了解訊息路由,請參閱教學課程:使用 IoT 中樞訊息路由將裝置資料傳送至 Azure 儲存體。 在本教學課程中,您會建立儲存體路由,並使用 IoT 中樞中的裝置加以測試。