你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az iot hub message-route

注意

此参考是 Azure CLI（版本 2.37.0 或更高版本）的 azure-iot 扩展的一部分。 该扩展将在首次运行 az iot hub message-route 命令时自动安装。 详细了解扩展。

此命令组处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

管理 IoT 中心的路由。

命令

名称	说明	类型	状态
az iot hub message-route create	为IoT 中心添加路由。	分机	预览
az iot hub message-route delete	删除IoT 中心中的所有路由或提及路由。	分机	预览版
az iot hub message-route fallback	管理 IoT 中心的回退路由。	分机	预览版
az iot hub message-route fallback set	启用或禁用IoT 中心中的回退路由。	扩展	预览
az iot hub message-route fallback show	显示IoT 中心的回退路由。	扩展	预览版
az iot hub message-route list	获取IoT 中心中的所有路由。	分机	预览
az iot hub message-route show	获取有关IoT 中心中的路由的信息。	分机	预览
az iot hub message-route test	在IoT 中心中测试所有路由或提及路由。	分机	预览
az iot hub message-route update	更新IoT 中心的路由。	分机	预览

az iot hub message-route create

预览

命令组“iot 中心消息路由”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

为IoT 中心添加路由。

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

示例

为具有给定终结点和源类型“DeviceMessages”的IoT 中心创建路由。

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

使用给定终结点、源类型“DigitalTwinChangeEvents”和自定义条件为IoT 中心创建禁用的路由。

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

可选参数

--condition -c

评估为应用路由规则的条件。

默认值: true

--enabled -e

一个布尔值，指示是否启用到IoT 中心的路由。

接受的值: false, true

默认值: True

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot hub message-route delete

预览

命令组“iot 中心消息路由”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

删除IoT 中心中的所有路由或提及路由。

az iot hub message-route delete --hub-name
                                [--resource-group]
                                [--rn]
                                [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                                [--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}

必需参数

--hub-name -n

IoT 中心名称。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--rn --route --route-name

路由的名称。

--source-type --type -t

路由的源。

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

--yes -y

跳过用户提示。 指示接受操作。 主要用于自动化方案。 默认值：false。

接受的值: false, true

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot hub message-route list

预览

命令组“iot 中心消息路由”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取IoT 中心中的所有路由。

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

示例

从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-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--source-type --type -t

路由的源。

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

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot hub message-route show

预览

命令组“iot 中心消息路由”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取有关IoT 中心中的路由的信息。

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

示例

从IoT 中心获取路由信息。

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

必需参数

--hub-name -n

IoT 中心名称。

--rn --route --route-name

路由的名称。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot hub message-route test

预览

命令组“iot 中心消息路由”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

在IoT 中心中测试所有路由或提及路由。

可以提供用于测试路由的示例消息。

az iot hub message-route test --hub-name
                              [--ap]
                              [--body]
                              [--resource-group]
                              [--rn]
                              [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                              [--sp]

示例

从IoT 中心测试路由。

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

从IoT 中心测试源类型“DeviceMessages”的所有路由。

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}

必需参数

--hub-name -n

IoT 中心名称。

可选参数

--ap --app-properties

路由消息的应用属性。

--body -b

路由消息的正文。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--rn --route --route-name

路由的名称。

--source-type --type -t

路由的源。

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

--sp --system-properties

路由消息的系统属性。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot hub message-route update

预览

命令组“iot 中心消息路由”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

更新IoT 中心的路由。

可以在路由上更改源、终结点、条件或启用状态。

az iot hub message-route update --hub-name
                                --rn
                                [--condition]
                                [--en]
                                [--enabled {false, true}]
                                [--resource-group]
                                [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]

示例

将路由更新到给定终结点和源类型“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}

必需参数

--hub-name -n

IoT 中心名称。

--rn --route --route-name

路由的名称。

可选参数

--condition -c

评估为应用路由规则的条件。

--en --endpoint --endpoint-name

路由终结点的名称。 对于内置终结点，请使用终结点名称“events”。

--enabled -e

一个布尔值，指示是否启用到IoT 中心的路由。

接受的值: false, true

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--source-type --type -t

路由的源。

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

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。