Compartilhar via


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

--account -n

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
--resource-group -g

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.

--assign-identity

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

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

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--pna --public-network-access

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

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

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

SKU da conta de Atualização de Dispositivo.

Propriedade Valor
Valor padrão: Standard
Valores aceitos: Free, Standard
--tags

Tags de recursos. Recipiente de propriedades em pares de valores-chave com o seguinte formato: a=b c=d.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--account -n

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.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--resource-group -g

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

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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.

--resource-group -g

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--account -n

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.

--resource-group -g

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--account -n

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.

--add

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: []
--force-string

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

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--remove

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: []
--resource-group -g

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

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

--account -n

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.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--custom

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

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 30
--resource-group -g

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

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 3600
--updated

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False