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。