Share via

az dt twin telemetry

  • 參考

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分 （2.37.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 來取得完整偵錯記錄。