az iot hub message-route

  • 預覽

Note

此參考文獻是 Azure CLI（版本 2.73.0 或更高版本）azure-iot 擴充的一部分。 擴充功能會在您第一次執行 az iot hub message-route 命令時自動安裝。 深入了解擴充功能。

此命令群組處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

管理 IoT 中樞的路由。

命令

名稱 Description 類型 狀態
az iot hub message-route create

新增 IoT 中樞 的路由。

 Extension Preview
az iot hub message-route delete

刪除所有路由或 IoT 中樞 中提到的路由。

 Extension Preview
az iot hub message-route fallback

管理IoT中樞的後援路由。

 Extension Preview
az iot hub message-route fallback set

在 IoT 中樞 中啟用或停用備用路由。

 Extension Preview
az iot hub message-route fallback show

展示 IoT 中樞 的備用路徑。

 Extension Preview
az iot hub message-route list

把所有路由都放在 IoT 中樞 裡。

 Extension Preview
az iot hub message-route show

在 IoT 中樞 獲取路線資訊。

 Extension Preview
az iot hub message-route test

測試所有路由或在 IoT 中樞 中提到的路徑。

 Extension Preview
az iot hub message-route update

更新 IoT 中樞 的路由。

 Extension Preview

az iot hub message-route create

預覽

命令群組 'iot 中樞訊息路由' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

新增 IoT 中樞 的路由。

az iot hub message-route create --en --endpoint --endpoint-name
                                --hub-name
                                --rn --route --route-name
                                --source-type --type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}
                                [--acquire-policy-token]
                                [--change-reference]
                                [--condition]
                                [--enabled {false, true}]
                                [--resource-group]

範例

為 IoT 中樞 建立路由，並使用指定的端點和來源類型「DeviceMessages」。

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DeviceMessages

為內建端點和來源類型「DeviceMessages」建立 IoT 中樞 路由。

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name events --source DeviceMessages

為 IoT 中樞 建立一條已停用路由，使用指定的端點、來源類型「DigitalTwinChangeEvents」及自訂條件。

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DigitalTwinChangeEvents --condition {condition} --enabled false

必要參數

--en --endpoint --endpoint-name

路由端點的名稱。 針對內建端點，請使用端點名稱 『events』。

--hub-name -n

IoT 中樞 名稱。

--rn --route --route-name

路由的名稱。

--source-type --type -t

路由的來源。

屬性 值
接受的值: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--condition -c

評估為套用路由規則的條件。

屬性 值
預設值: true
--enabled -e

一個布林值表示是否啟用 IoT 中樞 路由。

屬性 值
預設值: True
接受的值: false, true
--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az iot hub message-route delete

預覽

命令群組 'iot 中樞訊息路由' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

刪除所有路由或 IoT 中樞 中提到的路由。

az iot hub message-route delete [--acquire-policy-token]
                                [--change-reference]
                                [--hub-name]
                                [--ids]
                                [--resource-group]
                                [--rn --route --route-name]
                                [--source-type --type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                                [--subscription]
                                [--yes {false, true}]

範例

從 IoT 中樞 刪除一條路由。

az iot hub message-route delete -n {iothub_name} --route-name {route_name}

從 IoT 中樞 刪除所有來源類型的「DeviceMessages」路由。

az iot hub message-route delete -n {iothub_name} --source DeviceMessages

刪除 IoT 中樞 上的所有路由。

az iot hub message-route delete -n {iothub_name}

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--hub-name -n

IoT 中樞 名稱。

屬性 值
參數群組: Resource Id Arguments
--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性 值
參數群組: Resource Id Arguments
--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

屬性 值
參數群組: Resource Id Arguments
--rn --route --route-name

路由的名稱。

--source-type --type -t

路由的來源。

屬性 值
接受的值: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

屬性 值
參數群組: Resource Id Arguments
--yes -y

略過使用者提示。 表示接受動作。 主要用於自動化案例。 預設：false。

屬性 值
接受的值: false, true
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az iot hub message-route list

預覽

命令群組 'iot 中樞訊息路由' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

把所有路由都放在 IoT 中樞 裡。

az iot hub message-route list [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--source-type --type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                              [--subscription]

範例

從 IoT 中樞 取得所有路由。

az iot hub message-route list -n {iothub_name}

從 IoT 中樞 取得所有來源類型「DeviceMessages」的路由。

az iot hub message-route list -n {iothub_name} --source DeviceMessages

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--hub-name -n

IoT 中樞 名稱。

屬性 值
參數群組: Resource Id Arguments
--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性 值
參數群組: Resource Id Arguments
--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

屬性 值
參數群組: Resource Id Arguments
--source-type --type -t

路由的來源。

屬性 值
接受的值: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

屬性 值
參數群組: Resource Id Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az iot hub message-route show

預覽

命令群組 'iot 中樞訊息路由' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

在 IoT 中樞 獲取路線資訊。

az iot hub message-route show --rn --route --route-name
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]

範例

從 IoT 中樞 取得路線資訊。

az iot hub message-route show -n {iothub_name} --route-name {route_name}

必要參數

--rn --route --route-name

路由的名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--hub-name -n

IoT 中樞 名稱。

屬性 值
參數群組: Resource Id Arguments
--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性 值
參數群組: Resource Id Arguments
--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

屬性 值
參數群組: Resource Id Arguments
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

屬性 值
參數群組: Resource Id Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az iot hub message-route test

預覽

命令群組 'iot 中樞訊息路由' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

測試所有路由或在 IoT 中樞 中提到的路徑。

您可以提供範例訊息來測試您的路由。

az iot hub message-route test [--acquire-policy-token]
                              [--ap --app-properties]
                              [--body]
                              [--change-reference]
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--rn --route --route-name]
                              [--source-type --type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                              [--sp --system-properties]
                              [--subscription]

範例

測試從 IoT 中樞 的路由。

az iot hub message-route test -n {iothub_name} --route-name {route_name}

測試所有來源類型為「DeviceMessages」的路由，從 IoT 中樞 出發。

az iot hub message-route test -n {iothub_name} --source DeviceMessages

測試所有路由，從 IoT 中樞 附上自訂訊息，包括主體、應用程式屬性和系統屬性。

az iot hub message-route test -n {iothub_name} -b {body} --ap {app_properties} --sp {system_properties}

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--ap --app-properties

路由訊息的應用程式屬性。

--body -b

路由訊息的本文。

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--hub-name -n

IoT 中樞 名稱。

屬性 值
參數群組: Resource Id Arguments
--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性 值
參數群組: Resource Id Arguments
--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

屬性 值
參數群組: Resource Id Arguments
--rn --route --route-name

路由的名稱。

--source-type --type -t

路由的來源。

屬性 值
接受的值: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--sp --system-properties

路由訊息的系統屬性。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

屬性 值
參數群組: Resource Id Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az iot hub message-route update

預覽

命令群組 'iot 中樞訊息路由' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

更新 IoT 中樞 的路由。

您可以在路由上變更來源、端點、條件或啟用狀態。

az iot hub message-route update --rn --route --route-name
                                [--acquire-policy-token]
                                [--change-reference]
                                [--condition]
                                [--en --endpoint --endpoint-name]
                                [--enabled {false, true}]
                                [--hub-name]
                                [--ids]
                                [--resource-group]
                                [--source-type --type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                                [--subscription]

範例

更新路由至指定的端點和來源類型 「DeviceMessages」。。

az iot hub message-route update -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DeviceMessages

停用路由。

az iot hub message-route update -n {iothub_name} --route-name {route_name} --enabled false

變更路由的條件。

az iot hub message-route update -n {iothub_name} --route-name {route_name} --condition {condition}

必要參數

--rn --route --route-name

路由的名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--condition -c

評估為套用路由規則的條件。

--en --endpoint --endpoint-name

路由端點的名稱。 針對內建端點，請使用端點名稱 『events』。

--enabled -e

一個布林值表示是否啟用 IoT 中樞 路由。

屬性 值
接受的值: false, true
--hub-name -n

IoT 中樞 名稱。

屬性 值
參數群組: Resource Id Arguments
--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性 值
參數群組: Resource Id Arguments
--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

屬性 值
參數群組: Resource Id Arguments
--source-type --type -t

路由的來源。

屬性 值
接受的值: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

屬性 值
參數群組: Resource Id Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False