az iot adr ns su instance

Note

Essa referência faz parte da extensão azure-iot para o CLI do Azure (versão 2.73.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az iot adr ns su instance . Saiba mais sobre extensões.

O grupo de comandos 'iot adr ns' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerencie a Instância de Atualização que alimenta atualizações de software.

As Instâncias de Atualização são Microsoft de nível superior. Recursos deviceUpdate. Eles são agrupados aqui para a capacidade de descoberta do Registro de Dispositivo, mas não são filhos do namespace.

Comandos

Nome Description Tipo Status
az iot adr ns su instance check-name

Verifique se um nome de Instância de Atualização está disponível.

Extension Preview
az iot adr ns su instance create

Criar uma instância de atualização.

Extension Preview
az iot adr ns su instance delete

Excluir uma instância de atualização.

Extension Preview
az iot adr ns su instance list

Listar instâncias de atualização.

Extension Preview
az iot adr ns su instance show

Mostrar uma Instância de Atualização.

Extension Preview
az iot adr ns su instance update

Atualize as marcas ou a identidade gerenciada de uma Instância de Atualização.

Extension Preview
az iot adr ns su instance wait

Aguarde uma condição de Instância de Atualização.

Extension Preview

az iot adr ns su instance check-name

Versão Prévia

O grupo de comandos 'iot adr ns su instance' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Verifique se um nome de Instância de Atualização está disponível.

az iot adr ns su instance check-name --name
                                     [--acquire-policy-token]
                                     [--change-reference]

Exemplos

Verificar um nome

az iot adr ns su instance check-name -n myUpdateInstance

Parâmetros obrigatórios

--name -n

Nome da Instância de Atualização.

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy 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 adr ns su instance create

Versão Prévia

O grupo de comandos 'iot adr ns su instance' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Criar uma instância de atualização.

Cria um Microsoft. Recurso DeviceUpdate/updateInstances. Os argumentos de identidade gerenciada podem ser combinados e descrever o estado de identidade desejado completo quando fornecidos. Executar novamente a criação sem nenhuma das opções de identidade preserva a configuração SAMI/UAMI de uma instância existente, as marcas e o estado gerenciado pelo serviço.

az iot adr ns su instance create --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--location]
                                 [--mi-sa --system-assigned-mi {false, true}]
                                 [--mi-ua --user-assigned-mi]
                                 [--no-wait]
                                 [--tags]

Exemplos

Criar uma instância com uma identidade atribuída pelo sistema

az iot adr ns su instance create -n myUpdateInstance -g myResourceGroup --location eastus2 --system-assigned-mi

Criar uma instância com identidades atribuídas pelo sistema e pelo usuário

az iot adr ns su instance create -n myUpdateInstance -g myResourceGroup \
  --system-assigned-mi --user-assigned-mi /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity>

Substituir uma identidade de instância existente por uma configuração somente atribuída pelo usuário

az iot adr ns su instance create -n myUpdateInstance -g myResourceGroup \
  --user-assigned-mi /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity>

Parâmetros obrigatórios

--name -n

Nome da Instância de Atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--mi-sa --system-assigned-mi

Inclua ou remova a identidade gerenciada atribuída pelo sistema. Ao criar ou atualizar, omitir todas as opções de identidade gerenciada preserva a identidade existente.

Propriedade Valor
Valores aceitos: false, true
--mi-ua --user-assigned-mi

Conclua o conjunto desejado de IDs de recurso de identidade gerenciada atribuídas pelo usuário. Ao criar ou atualizar, omitir todas as opções de identidade gerenciada preserva a identidade existente.

--no-wait

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

Propriedade Valor
Valor padrão: False
--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

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 adr ns su instance delete

Versão Prévia

O grupo de comandos 'iot adr ns su instance' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Excluir uma instância de atualização.

az iot adr ns su instance delete --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--no-wait]
                                 [--yes {false, true}]

Exemplos

Excluir sem solicitar

az iot adr ns su instance delete -n myUpdateInstance -g myResourceGroup --yes

Parâmetros obrigatórios

--name -n

Nome da Instância de Atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--no-wait

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

Propriedade Valor
Valor padrão: False
--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: falso.

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 adr ns su instance list

Versão Prévia

O grupo de comandos 'iot adr ns su instance' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar instâncias de atualização.

az iot adr ns su instance list [--resource-group]

Exemplos

Listar instâncias em um grupo de recursos

az iot adr ns su instance list -g myResourceGroup

Listar instâncias na assinatura

az iot adr ns su instance list

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. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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 adr ns su instance show

Versão Prévia

O grupo de comandos 'iot adr ns su instance' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Mostrar uma Instância de Atualização.

az iot adr ns su instance show --name
                               --resource-group

Exemplos

Mostrar uma instância

az iot adr ns su instance show -n myUpdateInstance -g myResourceGroup

Parâmetros obrigatórios

--name -n

Nome da Instância de Atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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 adr ns su instance update

Versão Prévia

O grupo de comandos 'iot adr ns su instance' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualize as marcas ou a identidade gerenciada de uma Instância de Atualização.

As opções de identidade descrevem o estado de identidade desejado completo quando fornecido: --system-assigned-mi controls SAMI e --user-assigned-mi fornece o conjunto de interface do usuário. Omita ambas as opções de identidade para deixar a identidade existente inalterada.

az iot adr ns su instance update --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--mi-sa --system-assigned-mi {false, true}]
                                 [--mi-ua --user-assigned-mi]
                                 [--no-wait]
                                 [--tags]

Exemplos

Atualizar marcas

az iot adr ns su instance update -n myUpdateInstance -g myResourceGroup --tags environment=test

Definir a identidade como atribuída pelo sistema

az iot adr ns su instance update -n myUpdateInstance -g myResourceGroup --system-assigned-mi

Parâmetros obrigatórios

--name -n

Nome da Instância de Atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--mi-sa --system-assigned-mi

Inclua ou remova a identidade gerenciada atribuída pelo sistema. Ao criar ou atualizar, omitir todas as opções de identidade gerenciada preserva a identidade existente.

Propriedade Valor
Valores aceitos: false, true
--mi-ua --user-assigned-mi

Conclua o conjunto desejado de IDs de recurso de identidade gerenciada atribuídas pelo usuário. Ao criar ou atualizar, omitir todas as opções de identidade gerenciada preserva a identidade existente.

--no-wait

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

Propriedade Valor
Valor padrão: False
--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

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 adr ns su instance wait

Versão Prévia

O grupo de comandos 'iot adr ns su instance' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Aguarde uma condição de Instância de Atualização.

Sem um predicado de espera explícito, aguarda provisioningState Bem-sucedido.

az iot adr ns su instance wait --name
                               --resource-group
                               [--acquire-policy-token]
                               [--change-reference]
                               [--created]
                               [--custom]
                               [--deleted]
                               [--exists]
                               [--interval]
                               [--timeout]
                               [--updated]

Exemplos

Aguarde até que o provisionamento seja bem-sucedido

az iot adr ns su instance wait -n myUpdateInstance -g myResourceGroup

Parâmetros obrigatórios

--name -n

Nome da Instância de Atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--created

Aguarde até que provisioningState seja bem-sucedido.

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

Aguarde até que uma expressão JMESPath personalizada seja avaliada como true.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até que o recurso seja 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
--timeout

Orçamento de sondagem em segundos, incluindo tempo GET. Um GET a bordo é limitado por tempos limite de transporte e não pode ser interrompido por este prazo de sondagem.

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

Aguarde até que provisioningState seja bem-sucedido.

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