Partilhar via

az iot du account

  • Referência

Nota

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.46.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.

 Extensão GA
az iot du account delete

Exclua uma conta de Atualização de Dispositivo.

 Extensão GA
az iot du account list

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

 Extensão GA
az iot du account private-endpoint-connection

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

 Extensão GA
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.

 Extensão GA
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.

 Extensão GA
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.

 Extensão GA
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.

 Extensão GA
az iot du account private-link-resource

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

 Extensão GA
az iot du account private-link-resource list

Listar recursos de link privado suportados pela conta.

 Extensão GA
az iot du account show

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

 Extensão GA
az iot du account update

Atualizar uma conta de Atualização de Dispositivo.

 Extensão GA
az iot du account wait

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

 Extensão GA

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

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

Parâmetros Opcionais

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

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

Default value: False
--pna --public-network-access

Indica se a conta de Atualização de Dispositivo pode ser acessada de uma rede pública.

Valores aceites: Disabled, Enabled
Default value: Enabled
--role

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

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.

--sku

SKU da conta de Atualização de Dispositivo.

Valores aceites: Free, Standard
Default value: 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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

Parâmetros Opcionais

--no-wait

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

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

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

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

Parâmetros Opcionais

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

Parâmetros Opcionais

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

Default value: []
--force-string

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

Default value: False
--no-wait

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

Default value: False
--remove

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

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

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Default value: []
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

Parâmetros Opcionais

--created

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

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'].

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--interval

Intervalo de sondagem em segundos.

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

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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