使用 Azure PowerShell 建立和刪除路由與端點
本文說明如何在 Azure IoT 中樞的中樞中建立路由和端點,然後刪除您的路由和端點。 了解如何使用 Azure PowerShell 來建立 Azure 事件中樞、Azure 服務匯流排佇列和主題,以及 Azure 儲存體的路由和端點。
若要深入了解路猶如何在 IoT 中樞運作,請參閱使用 IoT 中樞訊息路由將裝置到雲端的訊息傳送至不同端點。 若要逐步解說如何設定路由以將訊息傳送至儲存體,並在模擬裝置上進行測試,請參閱教學課程: 使用 IoT 中樞訊息路由將裝置資料傳送至 Azure 儲存體。
注意
目前,PowerShell 不支援用來建立端點的受控識別驗證類型。 如果您在案例中無法使用 SAS 驗證,請使用其他其中一個管理工具來建立端點。
此外,PowerShell 目前不支援建立 Cosmos DB 端點。
必要條件
根據您要將訊息路由傳送至的端點類型,檢閱本文的必要條件。
Azure 訂用帳戶。 如果您沒有 Azure 訂用帳戶,請在開始前建立免費 Azure 帳戶。
IoT 中樞。 如果您沒有中樞,您可以遵循建立IoT中樞的步驟。
Azure PowerShell。 若要在本機使用 Azure PowerShell,請在電腦上安裝 Azure PowerShell 模組。 或者,若要在網頁瀏覽器中使用 Azure PowerShell,請啟用 Azure Cloud Shell。
事件中樞資源 (包含容器)。 如果您需要建立新的事件中樞資源,請參閱 快速入門:建立事件中樞。
(建議)具有事件中樞命名空間角色型訪問控制許可權的受控識別。 如需詳細資訊,請參閱 使用 Microsoft Entra ID 驗證受控識別,以存取事件中樞資源。
建立端點
在 IoT 中樞中,您可以建立路由來傳送訊息或擷取事件。 每個路由都有一個資料來源和端點。 訊息或事件記錄檔源自於資料來源。 端點是訊息或事件記錄檔最後出現的位置。 當您在 IoT 中樞中建立新路由時,您可以選擇資料來源和端點的位置。 接著,您可以在訊息或事件傳送至端點前,使用路由查詢進行篩選。
您用來建立端點的服務必須先存在於 Azure 帳戶中。
注意
如果您使用本機版本的 Azure PowerShell,請在開始之前登入 Azure PowerShell。
下列程序中的命令會使用這些參考:
從事件中樞取得主要連接字串。 複製連接字串以供後續使用。
Get-AzEventHubKey -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule
將新的 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-AzIotHubRoute。 Enabled
參數是參數,因此您不需要搭配參數使用值。
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 中樞中的裝置加以測試。