az iot adr ns su instance
Note
Esta referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.73.0 ou superior). A extensão instala-se automaticamente na primeira vez que executares um comando de instância AZ IOT ADR NS. Saiba mais sobre extensões.
O grupo de comando 'iot adr ns' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Gerir a Instância de Atualização que alimenta as Atualizações de Software.
As Instâncias de Atualização são de topo da Microsoft. Recursos do DeviceUpdate. Estão agrupados aqui para a descoberta do Registo de Dispositivos, mas não são filhos do namespace.
Comandos
| Nome | Descrição | Tipo | Estado |
|---|---|---|---|
| az iot adr ns su instance check-name |
Verifique se existe um nome de Atualização da Instância. |
Extension | Preview |
| az iot adr ns su instance create |
Crie uma Instância de Atualização. |
Extension | Preview |
| az iot adr ns su instance delete |
Apagar uma Instância de Atualização. |
Extension | Preview |
| az iot adr ns su instance list |
Listar Atualizações de Instâncias. |
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 etiquetas ou a identidade gerida de uma Instância de Atualização. |
Extension | Preview |
| az iot adr ns su instance wait |
Esperar por uma condição de Atualização da Instância. |
Extension | Preview |
az iot adr ns su instance check-name
O grupo de comando 'iot adr ns su instance' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Verifique se existe um nome de Atualização da Instância.
az iot adr ns su instance check-name --name
[--acquire-policy-token]
[--change-reference]
Exemplos
Verifica um nome
az iot adr ns su instance check-name -n myUpdateInstance
Parâmetros Obrigatórios
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 tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
az iot adr ns su instance create
O grupo de comando 'iot adr ns su instance' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Crie uma Instância de Atualização.
Cria um recurso Microsoft. DeviceUpdate/updateInstances. Argumentos de identidade gerida podem ser combinados e descrever o estado de identidade completo desejado quando fornecidos. Reexecutar o create sem nenhuma das opções de identidade preserva a configuração SAMI/UAMI, as etiquetas e o estado de gestão do serviço de uma instância existente.
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
Crie 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
Crie uma instância com identidades atribuídas pelo sistema e pelo utilizador
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 atribuída apenas pelo utilizador
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
Nome da Instância de Atualização.
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 tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Incluir ou remover a identidade gerida atribuída pelo sistema. Na criação ou atualização, omitir todas as opções de identidade gerida preserva a identidade existente.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
Complete o conjunto desejado de IDs de recursos de identidade gerida atribuídos pelo utilizador. Na criação ou atualização, omitir todas as opções de identidade gerida preserva a identidade existente.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
az iot adr ns su instance delete
O grupo de comando 'iot adr ns su instance' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Apagar 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
Apagar sem necessidade de ser solicitado
az iot adr ns su instance delete -n myUpdateInstance -g myResourceGroup --yes
Parâmetros Obrigatórios
Nome da Instância de Atualização.
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 tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
az iot adr ns su instance list
O grupo de comando 'iot adr ns su instance' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Listar Atualizações de Instâncias.
az iot adr ns su instance list [--resource-group]
Exemplos
Listar instâncias num grupo de recursos
az iot adr ns su instance list -g myResourceGroup
Listar as instâncias na subscrição
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 tornar-se necessários para que o comando seja executado com êxito.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
az iot adr ns su instance show
O grupo de comando 'iot adr ns su instance' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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
Nome da Instância de Atualização.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
az iot adr ns su instance update
O grupo de comando 'iot adr ns su instance' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Atualize as etiquetas ou a identidade gerida de uma Instância de Atualização.
As opções de identidade descrevem o estado completo desejado de identidade quando fornecidas: --system-assigned-mi controla SAMI e --user-assigned-mi fornece o conjunto UAMI. Omite ambas as opções de identidade para manter 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 tags
az iot adr ns su instance update -n myUpdateInstance -g myResourceGroup --tags environment=test
Defina a identidade como atribuída ao sistema
az iot adr ns su instance update -n myUpdateInstance -g myResourceGroup --system-assigned-mi
Parâmetros Obrigatórios
Nome da Instância de Atualização.
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 tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Incluir ou remover a identidade gerida atribuída pelo sistema. Na criação ou atualização, omitir todas as opções de identidade gerida preserva a identidade existente.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
Complete o conjunto desejado de IDs de recursos de identidade gerida atribuídos pelo utilizador. Na criação ou atualização, omitir todas as opções de identidade gerida preserva a identidade existente.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
az iot adr ns su instance wait
O grupo de comando 'iot adr ns su instance' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Esperar por uma condição de Atualização da Instância.
Sem um predicado explícito de espera, espera por provisioningEstado Succeeded.
az iot adr ns su instance wait --name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Exemplos
Esperar até que o provisionamento tenha sucesso
az iot adr ns su instance wait -n myUpdateInstance -g myResourceGroup
Parâmetros Obrigatórios
Nome da Instância de Atualização.
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 tornar-se necessários para que o comando seja executado com êxito.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Espere até que o Estado de Provisionamento seja Sucedido.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor predefinido: | False |
Espere até que uma expressão JMESPath personalizada seja avaliada como verdadeira.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
Espera até que o recurso seja eliminado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor predefinido: | False |
Aguarde até que o recurso exista.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor predefinido: | False |
Intervalo de sondagem em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor predefinido: | 30 |
Orçamento de sondagens em segundos, incluindo tempo de GET. Um GET em voo está limitado por tempos de espera de transporte e não pode ser interrompido por este prazo de votação.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor predefinido: | 3600 |
Espere até que o Estado de Provisionamento seja Sucedido.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor predefinido: | False |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |