Partilhar 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 será instalada 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

Name Description Tipo Status
az iot du account create

Crie uma conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account delete

Exclua uma conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account list

Liste todas as contas de Atualização de Dispositivo em uma assinatura ou grupo de recursos.

Extension disponibilidade geral
az iot du account private-endpoint-connection

Gerenciamento de conexão de ponto final privado da conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account private-endpoint-connection delete

Exclua uma conexão de ponto de extremidade privada associada a uma conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account private-endpoint-connection list

Liste conexões de ponto de extremidade privadas associadas a uma conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account private-endpoint-connection set

Defina o estado de uma conexão de ponto de extremidade privada associada a uma conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account private-endpoint-connection show

Mostrar uma conexão de ponto de extremidade privada associada a uma conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account private-link-resource

Gerenciamento de recursos de link privado da conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account private-link-resource list

Listar recursos de link privado suportados pela conta.

Extension disponibilidade geral
az iot du account show

Mostrar os detalhes de uma conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account update

Atualizar uma conta de Atualização de Dispositivo.

Extension disponibilidade geral
az iot du account wait

Bloqueie até que um estado de recurso de conta desejado tenha sido atingido.

Extension disponibilidade geral

az iot du account create

Crie uma conta de Atualização de Dispositivo.

Este 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 de Atualização de Dispositivo de sku no grupo de recursos de destino com local e tags 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, em seguida, 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 ao sistema e ao usuário e, em seguida, 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 Obrigatórios

--account -n

Nome da conta de Atualização de 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 de 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 tornar-se necessários para que o comando seja executado com êxito.

--assign-identity

Aceita identidades atribuídas ao sistema ou ao usuário separadas por espaços. Use '[sistema]' para se referir à identidade atribuída ao sistema ou um ID de recurso para se referir a uma identidade atribuída ao usuário. Consulte a ajuda para obter exemplos.

Propriedade Valor
Grupo de parâmetros: Managed Service Identity Arguments
--location -l

Localização da conta de Atualização de 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 espere que a operação de longa duração termine.

Propriedade Valor
Default value: 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
Default value: Enabled
Valores aceites: Disabled, Enabled
--role

Nome da função ou ID que a identidade atribuída ao sistema terá.

Propriedade Valor
Grupo de parâmetros: Managed Service Identity Arguments
Default value: Contributor
--scopes

Escopos separados por espaço que a identidade atribuída ao 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
Default value: Standard
Valores aceites: Free, Standard
--tags

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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 Obrigatórios

--account -n

Nome da conta de Atualização de 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 tornar-se necessários para que o comando seja executado com êxito.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--resource-group -g

Nome do grupo de recursos da conta de Atualização de 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 os prompts do usuário. Indica a aceitação da ação. Usado principalmente para cenários de automação. Predefinição: false.

Propriedade Valor
Valores aceites: false, true
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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

Liste 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 tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

Nome do grupo de recursos da conta de Atualização de 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az iot du account show

Mostrar 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 Obrigatórios

--account -n

Nome da conta de Atualização de 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 tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

Nome do grupo de recursos da conta de Atualização de 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az iot du account update

Atualizar uma conta de Atualização de Dispositivo.

Atualmente, as seguintes propriedades de conta podem ser atualizadas - identity, publicNetworkAccess e tags.

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

Exemplos

Defina um atributo de tag de conta específico.

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

Desative o acesso à rede pública.

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

Parâmetros Obrigatórios

--account -n

Nome da conta de Atualização de 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 tornar-se necessários para que o comando seja executado com êxito.

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

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: False
--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: []
--resource-group -g

Nome do grupo de recursos da conta de Atualização de 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
Default value: []
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az iot du account wait

Bloqueie até que um estado de recurso de conta desejado tenha sido atingido.

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 Obrigatórios

--account -n

Nome da conta de Atualização de 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 tornar-se necessários para que o comando seja executado com êxito.

--created

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: False
--custom

Aguarde até que a condição satisfaç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
Default value: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: False
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: 30
--resource-group -g

Nome do grupo de recursos da conta de Atualização de 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
Default value: 3600
--updated

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False