az dt twin telemetry

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分（2.46.0 版或更高版本）。 擴充功能會在您第一次執行 az dt twin telemetry 命令時自動安裝。 深入了解擴充功能。

測試及驗證 Digital Twins 實例的事件路由和端點。

命令

名稱	Description	類型	狀態
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

Digital Twins 實例名稱或主機名。 如果提供實例名稱，則會先查詢使用者訂用帳戶，讓目標實例擷取主機名。 如果提供主機名，則會略過訂用帳戶查詢，並提供的值會用於後續的互動。

--twin-id -t

數字對應項識別碼。

選擇性參數

--component

DTDL 元件的路徑。 如果設定，則會代表元件發出遙測。

--dt-id

用於取消複製訊息的唯一訊息標識碼（在數字對應項標識符的範圍內）。 如果未提供任何值，則會自動產生 GUID。

--resource-group -g

Digital Twins 實例資源群組。 您可以使用 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

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。