通过

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

az dt twin telemetry

  • 参考

注意

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

测试和验证数字孪生实例的事件路由和终结点。

命令

名称 说明 类型 Status
az dt twin telemetry send

代表数字孪生发送遥测数据。 如果提供了组件路径，则发出的遥测数据代表组件。

 扩展 GA

az dt twin telemetry send

代表数字孪生发送遥测数据。 如果提供了组件路径，则发出的遥测数据代表组件。

az dt twin telemetry send --dt-name
                          --twin-id
                          [--component]
                          [--dt-id]
                          [--resource-group]
                          [--telemetry]
                          [--telemetry-source-time]

示例

发送孪生遥测

az dt twin telemetry send -n {instance_or_hostname} --twin-id {twin_id}

使用自定义遥测源时间戳和消息标识符发送孪生遥测

az dt twin telemetry send -n {instance_or_hostname} --twin-id {twin_id} --tst {telemetry_source_timestamp} --dt-id {dt_id}

必需参数

--dt-name --dtn -n

数字孪生实例名称或主机名。 如果提供了实例名称，则首先查询目标实例的用户订阅以检索主机名。 如果提供了主机名，则会跳过订阅查询，并提供的值用于后续交互。

--twin-id -t

数字孪生 ID。

可选参数

--component

DTDL 组件的路径。 如果设置，则代表组件发出遥测数据。

--dt-id

用于取消复制消息的唯一消息标识符（在数字孪生 ID 的范围内）。 如果未提供任何值，则自动生成 GUID。

--resource-group -g

数字孪生实例资源组。 可以使用 az configure --defaults group=<name> 配置默认组。

--telemetry

内联遥测 JSON 或遥测 JSON 的文件路径。 默认有效负载为空对象： {}。

--telemetry-source-time --tst

一个 RFC 3339 时间戳，用于标识遥测测量的时间。

全局参数
--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 获取完整的调试日志。