az iot ops asset dataset point

參考

注意

此參考是 Azure CLI 的 azure-iot-ops 擴充功能的一部分（2.53.0 版或更高版本）。擴充功能會在您第一次執行 az iot ops asset dataset point 命令時自動安裝。深入了解擴充功能。

管理資產數據集中的數據點。

命令

名稱	Description	類型	狀態
az iot ops asset dataset point add	將數據點新增至資產數據集。	副檔名	加語
az iot ops asset dataset point export	匯出資產數據集中的數據點。	副檔名	加語
az iot ops asset dataset point import	在資產數據集中匯入數據點。	副檔名	加語
az iot ops asset dataset point list	列出資產數據集中的數據點。	副檔名	加語
az iot ops asset dataset point remove	拿掉資產數據集中的數據點。	副檔名	加語

az iot ops asset dataset point add

將數據點新增至資產數據集。

如果尚未存在數據集，這會建立新的數據集。目前，只有一個數據集支援名稱為 “default”。

az iot ops asset dataset point add --asset
                                   --data-source
                                   --dataset
                                   --name
                                   --resource-group
                                   [--observability-mode]
                                   [--qs]
                                   [--replace {false, true}]
                                   [--sampling-interval]

範例

將數據點新增至資產。

az iot ops asset dataset point add --asset myasset -g myresourcegroup --dataset default --data-source mydatasource --name data1

將數據點新增至具有數據點名稱、可觀察模式、自定義佇列大小和自定義取樣間隔的資產。

az iot ops asset dataset point add --asset myasset -g myresourcegroup --dataset default --data-source mydatasource --name data1 --observability-mode log --queue-size 5 --sampling-interval 200

必要參數

--asset -a

資產名稱。

--data-source --ds

資料來源。

--dataset -d

數據集名稱。

--name -n

數據點名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--observability-mode --om

可檢視模式。必須是 none、量測計、計數器、直方圖或記錄。

--qs --queue-size

自定義佇列大小。

--replace

如果已有同名的另一個數據點，請取代數據點。

接受的值: false, true

--sampling-interval --si

自定義取樣間隔（以毫秒為單位）。

全域參數

--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 來取得完整偵錯記錄。

az iot ops asset dataset point export

匯出資產數據集中的數據點。

文件名會是 {asset_name}_{dataset_name}_dataPoints。{file_type}。

az iot ops asset dataset point export --asset
                                      --dataset
                                      --resource-group
                                      [--format {csv, json, yaml}]
                                      [--od]
                                      [--replace {false, true}]

範例

以 JSON 格式匯出資產中的所有數據點。

az iot ops asset dataset point export --asset myasset -g myresourcegroup --dataset default

在可透過數位作業體驗上傳的特定輸出目錄中，以 CSV 格式匯出資產中的所有數據點。

az iot ops asset dataset point export --asset myasset -g myresourcegroup --dataset default --format csv --output-dir myAssetsFiles

以 YAML 格式匯出資產中的所有數據點。如果已有檔案，請取代檔案。

az iot ops asset dataset point export --asset myasset -g myresourcegroup --dataset default --format yaml --replace

必要參數

--asset -a

資產名稱。

--dataset -d

數據集名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--format -f

檔案格式。

接受的值: csv, json, yaml

預設值: json

--od --output-dir

匯出檔案的輸出目錄。

--replace

如果存在，請取代本機檔案。

接受的值: false, true

預設值: False

全域參數

--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 來取得完整偵錯記錄。

az iot ops asset dataset point import

在資產數據集中匯入數據點。

如需檔格式的範例，請參閱 aka.ms/aziotops-assets。

az iot ops asset dataset point import --asset
                                      --dataset
                                      --if
                                      --resource-group
                                      [--replace {false, true}]

範例

從檔案匯入所有數據點。這些數據點將會附加至資產數據集目前的數據點。將會忽略具有重複名稱的數據點。

az iot ops asset dataset point import --asset myasset -g myresourcegroup --dataset default --input-file myasset_default_dataPoints.csv

從檔案匯入所有數據點。這些數據點將會附加至資產數據集目前的數據點。具有重複名稱的數據點將會取代目前的資產數據點。

az iot ops asset dataset point import --asset myasset -g myresourcegroup --dataset default --input-file myasset_default_dataPoints.json --replace

必要參數

--asset -a

資產名稱。

--dataset -d

數據集名稱。

--if --input-file

包含數據點之檔案的檔案路徑。支援下列檔類型：json、csv、yaml。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--replace

將重複的資產數據點取代為來自檔案的資產數據點。如果為 false，則會忽略檔案數據點。重複的資產數據點將由名稱決定。

接受的值: false, true

預設值: False

全域參數

--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 來取得完整偵錯記錄。

az iot ops asset dataset point list

列出資產數據集中的數據點。

az iot ops asset dataset point list --asset
                                    --dataset
                                    --resource-group

範例

列出資產數據集中的所有點。

az iot ops asset dataset point list --asset myasset -g myresourcegroup --dataset default

必要參數

--asset -a

資產名稱。

--dataset -d

數據集名稱。

--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

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

--verbose

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

az iot ops asset dataset point remove

拿掉資產數據集中的數據點。

az iot ops asset dataset point remove --asset
                                      --dataset
                                      --name
                                      --resource-group

範例

透過數據點名稱從資產中移除數據點。

az iot ops asset dataset point remove --asset myasset -g myresourcegroup --dataset default --name data1

必要參數

--asset -a

資產名稱。

--dataset -d

數據集名稱。

--name -n

數據點名稱。

--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

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

--verbose

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

共用方式為

az iot ops asset dataset point

命令

az iot ops asset dataset point add

範例

必要參數

選擇性參數

az iot ops asset dataset point export

範例

必要參數

選擇性參數

az iot ops asset dataset point import

範例

必要參數

選擇性參數

az iot ops asset dataset point list

範例

必要參數

az iot ops asset dataset point remove

範例

必要參數

其他資源