你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az iot du account

参考

注意

此参考是 Azure CLI（版本 2.37.0 或更高版本）的 azure-iot 扩展的一部分。该扩展将在首次运行 az iot du account 命令时自动安装。详细了解扩展。

设备更新帐户管理。

命令

名称	说明	类型	状态
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

设备更新帐户名称。可以使用 < a0/> 配置默认帐户名称 az config set defaults.adu_account=<name>。

--resource-group -g

设备更新帐户资源组名称。可以使用 az config set defaults.adu_group=<name> 配置默认组。

可选参数

--assign-identity

接受由空格分隔的系统或用户分配标识。使用“[system]”来引用系统分配的标识，或使用资源 ID 来引用用户分配的标识。查看有关示例的帮助。

--location -l

设备更新帐户位置。如果未提供任何位置，则使用资源组位置。可以使用 az configure --defaults location=<name> 配置默认位置。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--pna --public-network-access

指示是否可以从公用网络访问设备更新帐户。

接受的值: Disabled, Enabled

默认值: Enabled

--role

系统分配的标识将具有的角色名称或 ID。

默认值: 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

订阅的名称或 ID。可以使用 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

设备更新帐户名称。可以使用 < a0/> 配置默认帐户名称 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

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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

设备更新帐户名称。可以使用 < a0/> 配置默认帐户名称 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

订阅的名称或 ID。可以使用 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

设备更新帐户名称。可以使用 < a0/> 配置默认帐户名称 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> OR --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

订阅的名称或 ID。可以使用 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

设备更新帐户名称。可以使用 < a0/> 配置默认帐户名称 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

订阅的名称或 ID。可以使用 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

示例

必需参数

可选参数

反馈

其他资源