az iot du device

注意

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

裝置更新裝置管理。

命令

名稱	Description	類型	狀態
az iot du device class	裝置類別和裝置類別子群組管理。	副檔名	GA
az iot du device class delete	刪除裝置類別或裝置類別子群組。	副檔名	GA
az iot du device class list	列出裝置類別或裝置類別子群組。	副檔名	GA
az iot du device class show	顯示裝置類別或裝置類別子群組的詳細數據，包括可安裝的更新、最佳更新和更新合規性。	副檔名	GA
az iot du device class update	更新裝置類別。	副檔名	GA
az iot du device compliance	實例檢視裝置合規性公用程式。	副檔名	GA
az iot du device compliance show	取得最新更新中有多少裝置、有可用的新更新，或正在進行接收新更新的明細。	副檔名	GA
az iot du device deployment	裝置部署管理。	副檔名	GA
az iot du device deployment cancel	取消裝置類別子群組部署。	副檔名	GA
az iot du device deployment create	建立裝置群組的部署。 部署將會針對目標群組內的每個裝置類別子群組進行多重轉換。	副檔名	GA
az iot du device deployment delete	依裝置群組或裝置類別子群組刪除部署。	副檔名	GA
az iot du device deployment list	列出裝置群組或裝置類別子群組的部署。	副檔名	GA
az iot du device deployment list-devices	列出裝置類別子群組部署中的裝置及其狀態。 適用於取得失敗的裝置清單。	副檔名	GA
az iot du device deployment retry	重試裝置類別子群組部署。	副檔名	GA
az iot du device deployment show	顯示裝置群組或裝置類別子群組的部署，包括狀態，詳細說明部署中有多少裝置正在進行、已完成或失敗。	副檔名	GA
az iot du device group	裝置群組管理。	副檔名	GA
az iot du device group delete	刪除裝置群組。	副檔名	GA
az iot du device group list	列出實例內的裝置群組。	副檔名	GA
az iot du device group show	顯示裝置群組的詳細數據，包括最佳更新和更新合規性。	副檔名	GA
az iot du device health	裝置健康情況檢查公用程式。	副檔名	GA
az iot du device health list	列出目標篩選條件的裝置健康情況。	副檔名	GA
az iot du device import	從連結 IoT 中樞 將裝置和模組匯入到裝置更新實例。	副檔名	GA
az iot du device list	列出實例中包含的裝置身分識別。	副檔名	GA
az iot du device log	實例記錄收集管理。	副檔名	GA
az iot du device log collect	在指定的裝置上設定裝置診斷記錄收集作業。	副檔名	GA
az iot du device log list	列出實例診斷記錄收集作業。	副檔名	GA
az iot du device log show	顯示特定的實例診斷記錄收集作業。	副檔名	GA
az iot du device module	裝置模組管理。	副檔名	GA
az iot du device module show	顯示匯入至實例的裝置模組身分識別。	副檔名	GA
az iot du device show	顯示實例內含的裝置身分識別。	副檔名	GA

az iot du device import

從連結 IoT 中樞 將裝置和模組匯入至裝置更新實例。

az iot du device import --account
                        --instance
                        [--import-type {All, Devices, Modules}]
                        [--resource-group]

範例

將裝置和模組匯入目標實例。

az iot du device import -n {account_name} -i {instance_name}

只匯入裝置。

az iot du device import -n {account_name} -i {instance_name} --import-type Devices

只匯入模組。

az iot du device import -n {account_name} -i {instance_name} --import-type Modules

必要參數

--account -n

裝置更新帳戶名稱。 您可以使用 來設定預設帳戶名稱 az config set defaults.adu_account=<name>。

--instance -i

裝置更新實例名稱。 您可以使用 來設定預設實例名稱 az config set defaults.adu_instance=<name>。

選擇性參數

--import-type --it

要從 IoT 中樞 匯入的裝置類型。

接受的值: All, Devices, Modules

預設值: All

--resource-group -g

裝置更新帳戶資源組名。 您可以使用 az config set defaults.adu_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 du device list

列出實例中包含的裝置身分識別。

az iot du device list --account
                      --instance
                      [--filter]
                      [--resource-group]

範例

列出目標實例內的裝置身分識別。

az iot du device list -n {account_name} -i {instance_name}

列出目標實例內依所需群組標識碼進行篩選的裝置身分識別。

az iot du device list -n {account_name} -i {instance_name} --filter "groupId eq 'myDeviceGroup'"

必要參數

--account -n

裝置更新帳戶名稱。 您可以使用 來設定預設帳戶名稱 az config set defaults.adu_account=<name>。

--instance -i

裝置更新實例名稱。 您可以使用 來設定預設實例名稱 az config set defaults.adu_instance=<name>。

選擇性參數

--filter

限制傳回的裝置集。 您可以篩選 groupId、deviceClassId 或 groupId 和 deploymentStatus。

--resource-group -g

裝置更新帳戶資源組名。 您可以使用 az config set defaults.adu_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 du device show

顯示實例內含的裝置身分識別。

az iot du device show --account
                      --device-id
                      --instance
                      [--resource-group]

範例

在目標實例內顯示裝置身分識別。

az iot du device show -n {account_name} -i {instance_name} -d {device_id}

必要參數

--account -n

裝置更新帳戶名稱。 您可以使用 來設定預設帳戶名稱 az config set defaults.adu_account=<name>。

--device-id -d

目標裝置標識碼。

--instance -i

裝置更新實例名稱。 您可以使用 來設定預設實例名稱 az config set defaults.adu_instance=<name>。

選擇性參數

--resource-group -g

裝置更新帳戶資源組名。 您可以使用 az config set defaults.adu_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 來取得完整偵錯記錄。