az iot du account

參考

注意

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

裝置更新帳戶管理。

命令

名稱	Description	類型	狀態
az iot du account create	建立裝置更新帳戶。	副檔名	GA
az iot du account delete	刪除裝置更新帳戶。	副檔名	GA
az iot du account list	列出訂用帳戶或資源群組中的所有裝置更新帳戶。	副檔名	GA
az iot du account private-endpoint-connection	裝置更新帳戶私人端點連線管理。	副檔名	GA
az iot du account private-endpoint-connection delete	刪除與裝置更新帳戶相關聯的私人端點連線。	副檔名	GA
az iot du account private-endpoint-connection list	列出與裝置更新帳戶相關聯的私人端點連線。	副檔名	GA
az iot du account private-endpoint-connection set	設定與裝置更新帳戶相關聯的私人端點連線狀態。	副檔名	GA
az iot du account private-endpoint-connection show	顯示與裝置更新帳戶相關聯的私人端點連線。	副檔名	GA
az iot du account private-link-resource	裝置更新帳戶私人鏈接資源管理。	副檔名	GA
az iot du account private-link-resource list	列出帳戶所支援的私人鏈接資源。	副檔名	GA
az iot du account show	顯示裝置更新帳戶的詳細數據。	副檔名	GA
az iot du account update	更新裝置更新帳戶。	副檔名	GA
az iot du account wait	封鎖，直到符合所需的帳戶資源狀態為止。	副檔名	GA

az iot du account create

建立裝置更新帳戶。

此命令也可用來更新現有帳戶的狀態。

az iot du account create --account
                         --resource-group
                         [--assign-identity]
                         [--location]
                         [--no-wait]
                         [--pna {Disabled, Enabled}]
                         [--role]
                         [--scopes]
                         [--sku {Free, Standard}]
                         [--tags]

範例

使用資源群組位置在目標資源群組中建立裝置更新帳戶。

az iot du account create -n {account_name} -g {resouce_group}

在目標資源群組中建立具有指定位置和標籤的免費 SKU 裝置更新帳戶，而不會封鎖。

az iot du account create -n {account_name} -g {resouce_group} -l westus --tags a=b c=d --sku Free --no-wait

使用系統受控識別在目標資源群組中建立裝置更新帳戶。

az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system]

使用系統受控識別在目標資源群組中建立裝置更新帳戶，然後將系統身分識別指派給具有參與者角色的單一範圍。

az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system] --scopes /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount

使用系統和使用者指派的受控識別，在目標資源群組中建立裝置更新帳戶，然後將系統身分識別指派給具有自定義指定角色的一或多個範圍（空格分隔）。

az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system] /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourcegroups/ProResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity --scopes /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount1
  /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount2
--role "Storage Blob Data Contributor"

必要參數

--account -n

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

--resource-group -g

裝置更新帳戶資源組名。您可以使用 az config set defaults.adu_group=<name> 來設定預設群組。

選擇性參數

--assign-identity

接受以空格分隔的系統或使用者指派身分識別。使用 '[system]' 來參考系統指派的身分識別，或使用資源標識符來參考使用者指派的身分識別。如需範例，請參閱說明。

--location -l

裝置更新帳戶位置。如果未提供任何位置，則會使用資源群組位置。您可以使用 az configure --defaults location=<name> 設定預設位置。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--pna --public-network-access

指出是否可以從公用網路存取裝置更新帳戶。

接受的值: Disabled, Enabled

預設值: Enabled

--role

系統指派身分識別的角色名稱或標識碼。

預設值: Contributor

--scopes

系統指派的身分識別可以存取的空間分隔範圍。無法搭配 --no-wait 使用。

--sku

裝置更新帳戶 SKU。

接受的值: Free, Standard

預設值: Standard

--tags

資源標籤。索引鍵/值組中的屬性包，格式如下：a=b c=d。

全域參數

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

刪除裝置更新帳戶。

az iot du account delete --account
                         [--no-wait]
                         [--resource-group]
                         [--yes {false, true}]

範例

刪除目標帳戶。

az iot du account delete -n {account_name}

刪除目標帳戶，而不需確認或封鎖。

az iot du account delete -n {account_name} -y --no-wait

必要參數

--account -n

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

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

裝置更新帳戶資源組名。您可以使用 az config set defaults.adu_group=<name> 來設定預設群組。

--yes -y

略過使用者提示。表示接受動作。主要用於自動化案例。預設：false。

接受的值: false, true

全域參數

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

列出訂用帳戶或資源群組中的所有裝置更新帳戶。

az iot du account list [--resource-group]

範例

列出訂用帳戶中的所有帳戶。

az iot du account list

列出訂用帳戶中符合篩選準則的帳戶。

az iot du account list --query "[?tags.env == 'test']"

列出資源群組中的所有帳戶。

az iot du account list -g {resource_group}

選擇性參數

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

顯示裝置更新帳戶的詳細數據。

az iot du account show --account
                       [--resource-group]

範例

顯示目標帳戶。

az iot du account show -n {account_name}

在特定屬性上顯示目標帳戶篩選。

az iot du account show -n {account_name} --query identity

必要參數

--account -n

裝置更新帳戶名稱。您可以使用來設定預設帳戶名稱 az config set defaults.adu_account=<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 來取得完整偵錯記錄。

az iot du account update

更新裝置更新帳戶。

目前可以更新下列帳戶屬性 - 身分識別、publicNetworkAccess 和標記。

az iot du account update --account
                         [--add]
                         [--force-string]
                         [--no-wait]
                         [--remove]
                         [--resource-group]
                         [--set]

範例

設定特定的帳戶標籤屬性。

az iot du account update -n {account_name} --set tags.env='test'

停用公用網路存取。

az iot du account update -n {account_name} --set publicNetworkAccess='Disabled'

必要參數

--account -n

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

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--remove

從清單中移除屬性或專案。範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

預設值: []

--resource-group -g

裝置更新帳戶資源組名。您可以使用 az config set defaults.adu_group=<name> 來設定預設群組。

--set

指定要設定的屬性路徑和值，以更新物件。範例：--set property1.property2=<value>。

預設值: []

全域參數

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

封鎖，直到符合所需的帳戶資源狀態為止。

az iot du account wait --account
                       [--created]
                       [--custom]
                       [--deleted]
                       [--exists]
                       [--interval]
                       [--resource-group]
                       [--timeout]
                       [--updated]

範例

封鎖直到帳戶資源完成更新為止。

az iot du account wait -n {account_name} -g {resource_group} --updated

必要參數

--account -n

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

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自定義 JMESPath 查詢為止。例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等候資源存在。

預設值: False

--interval

輪詢間隔以秒為單位。

預設值: 30

--resource-group -g

裝置更新帳戶資源組名。您可以使用 az config set defaults.adu_group=<name> 來設定預設群組。

--timeout

以秒為單位的等候上限。

預設值: 3600

--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: 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 du account

命令

az iot du account create

範例

必要參數

選擇性參數

az iot du account delete

範例

必要參數

選擇性參數

az iot du account list

範例

選擇性參數

az iot du account show

範例

必要參數

選擇性參數

az iot du account update

範例

必要參數

選擇性參數

az iot du account wait

範例

必要參數

選擇性參數

其他資源