az iot du account
Note
Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.67.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az iot du account. Saiba mais sobre extensões.
Gerenciamento de conta de atualização de dispositivo.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az iot du account create |
Crie uma conta de Atualização de Dispositivo. |
Extension | GA |
| az iot du account delete |
Exclua uma conta de Atualização de Dispositivo. |
Extension | GA |
| az iot du account list |
Liste todas as contas de Atualização de Dispositivo em uma assinatura ou grupo de recursos. |
Extension | GA |
| az iot du account private-endpoint-connection |
Gerenciamento de conexão de ponto de extremidade privado da conta de Atualização de Dispositivo. |
Extension | GA |
| az iot du account private-endpoint-connection delete |
Exclua uma conexão de ponto de extremidade privado associada a uma conta de Atualização de Dispositivo. |
Extension | GA |
| az iot du account private-endpoint-connection list |
Listar conexões de ponto de extremidade privado associadas a uma conta de Atualização de Dispositivo. |
Extension | GA |
| az iot du account private-endpoint-connection set |
Defina o estado de uma conexão de ponto de extremidade privado associada a uma conta de Atualização de Dispositivo. |
Extension | GA |
| az iot du account private-endpoint-connection show |
Mostrar uma conexão de ponto de extremidade privado associada a uma conta de Atualização de Dispositivo. |
Extension | GA |
| az iot du account private-link-resource |
Gerenciamento de recursos de link privado da conta de atualização de dispositivo. |
Extension | GA |
| az iot du account private-link-resource list |
Liste os recursos de link privado suportados pela conta. |
Extension | GA |
| az iot du account show |
Mostre os detalhes de uma conta de Atualização de Dispositivo. |
Extension | GA |
| az iot du account update |
Atualize uma conta de Atualização de Dispositivo. |
Extension | GA |
| az iot du account wait |
Bloqueie até que um estado de recurso de conta desejado seja atendido. |
Extension | GA |
az iot du account create
Crie uma conta de Atualização de Dispositivo.
Esse comando também pode ser usado para atualizar o estado de uma conta existente.
az iot du account create --account
--resource-group
[--assign-identity]
[--location]
[--no-wait]
[--pna --public-network-access {Disabled, Enabled}]
[--role]
[--scopes]
[--sku {Free, Standard}]
[--tags]
Exemplos
Crie uma conta de Atualização de Dispositivo no grupo de recursos de destino usando o local do grupo de recursos.
az iot du account create -n {account_name} -g {resouce_group}
Crie uma conta gratuita do SKU Device Update no grupo de recursos de destino com o local e as marcas especificados sem bloqueio.
az iot du account create -n {account_name} -g {resouce_group} -l westus --tags a=b c=d --sku Free --no-wait
Crie uma conta de Atualização de Dispositivo no grupo de recursos de destino com uma identidade gerenciada pelo sistema.
az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system]
Crie uma conta de Atualização de Dispositivo no grupo de recursos de destino com uma identidade gerenciada pelo sistema e atribua a identidade do sistema a um único escopo com a função de Colaborador.
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
Crie uma conta de Atualização de Dispositivo no grupo de recursos de destino com identidades gerenciadas atribuídas pelo sistema e pelo usuário e atribua a identidade do sistema a um ou mais escopos (separados por espaço) com uma função especificada personalizada.
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"
Parâmetros Exigidos
Nome da conta de Atualização do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Nome do grupo de recursos da conta de Atualização do Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Aceita identidades atribuídas pelo sistema ou pelo usuário separadas por espaços. Use '[system]' para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade atribuída pelo usuário. Confira a ajuda para obter exemplos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Managed Service Identity Arguments |
Local da conta de Atualização do Dispositivo. Se nenhum local for fornecido, o local do grupo de recursos será usado. Você pode configurar o local padrão usando az configure --defaults location={name}.
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Indica se a conta de Atualização de Dispositivo pode ser acessada de uma rede pública.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Network Arguments |
| Valor padrão: | Enabled |
| Valores aceitos: | Disabled, Enabled |
Nome da função ou ID que a identidade atribuída pelo sistema terá.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Managed Service Identity Arguments |
| Valor padrão: | Contributor |
Escopos separados por espaço que a identidade atribuída pelo sistema pode acessar. Não pode ser usado com --no-wait.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Managed Service Identity Arguments |
SKU da conta de Atualização de Dispositivo.
| Propriedade | Valor |
|---|---|
| Valor padrão: | Standard |
| Valores aceitos: | Free, Standard |
Tags de recursos. Recipiente de propriedades em pares de valores-chave com o seguinte formato: a=b c=d.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az iot du account delete
Exclua uma conta de Atualização de Dispositivo.
az iot du account delete --account
[--no-wait]
[--resource-group]
[--yes {false, true}]
Exemplos
Exclua uma conta de destino.
az iot du account delete -n {account_name}
Exclua uma conta de destino sem confirmação ou bloqueio.
az iot du account delete -n {account_name} -y --no-wait
Parâmetros Exigidos
Nome da conta de Atualização do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Nome do grupo de recursos da conta de Atualização do Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Ignore as solicitações do usuário. Indica a aceitação da ação. Usado principalmente para cenários de automação. Padrão: false.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az iot du account list
Liste todas as contas de Atualização de Dispositivo em uma assinatura ou grupo de recursos.
az iot du account list [--resource-group]
Exemplos
Listar todas as contas em uma assinatura.
az iot du account list
Listar contas em uma assinatura que atendam aos critérios de filtro.
az iot du account list --query "[?tags.env == 'test']"
Listar todas as contas em um grupo de recursos.
az iot du account list -g {resource_group}
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do grupo de recursos da conta de Atualização do Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az iot du account show
Mostre os detalhes de uma conta de Atualização de Dispositivo.
az iot du account show --account
[--resource-group]
Exemplos
Mostrar uma conta de destino.
az iot du account show -n {account_name}
Mostrar uma filtragem de conta de destino em uma propriedade específica.
az iot du account show -n {account_name} --query identity
Parâmetros Exigidos
Nome da conta de Atualização do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do grupo de recursos da conta de Atualização do Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az iot du account update
Atualize uma conta de Atualização de Dispositivo.
Atualmente, as seguintes propriedades da conta podem ser atualizadas - identidade, publicNetworkAccess e tags.
az iot du account update --account
[--add]
[--force-string]
[--no-wait]
[--remove]
[--resource-group]
[--set]
Exemplos
Defina um atributo de marca de conta específico.
az iot du account update -n {account_name} --set tags.env='test'
Desabilite o acesso a redes públicas.
az iot du account update -n {account_name} --set publicNetworkAccess='Disabled'
Parâmetros Exigidos
Nome da conta de Atualização do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Valor padrão: | [] |
Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Valor padrão: | False |
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Valor padrão: | [] |
Nome do grupo de recursos da conta de Atualização do Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Valor padrão: | [] |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az iot du account wait
Bloqueie até que um estado de recurso de conta desejado seja atendido.
az iot du account wait --account
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--resource-group]
[--timeout]
[--updated]
Exemplos
Bloqueie até que um recurso de conta termine de atualizar.
az iot du account wait -n {account_name} -g {resource_group} --updated
Parâmetros Exigidos
Nome da conta de Atualização do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Aguarde até ser criado com 'provisioningState' em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
Aguarde até ser excluído.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Aguarde até que o recurso exista.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Intervalo de sondagem em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | 30 |
Nome do grupo de recursos da conta de Atualização do Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group={name}.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Account Identifier Arguments |
Espera máxima em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | 3600 |
Aguarde até que seja atualizado com provisioningState em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |