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

Pré-visualizar

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

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

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

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

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: 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 de assinatura. 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
Valor predefinido: False

az iot adr ns su instance create

Pré-visualizar

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

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

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

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

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
--mi-ua --user-assigned-mi

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.

--no-wait

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

Propriedade Valor
Valor predefinido: False
--tags

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: 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 de assinatura. 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
Valor predefinido: False

az iot adr ns su instance delete

Pré-visualizar

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

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

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O ID de referência de alteração relacionado para esta operação de recurso.

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

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

Propriedade Valor
Valor predefinido: False
--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
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: 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 de assinatura. 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
Valor predefinido: False

az iot adr ns su instance list

Pré-visualizar

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.

--resource-group -g

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: 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 de assinatura. 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
Valor predefinido: False

az iot adr ns su instance show

Pré-visualizar

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

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

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: 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 de assinatura. 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
Valor predefinido: False

az iot adr ns su instance update

Pré-visualizar

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

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

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O ID de referência de alteração relacionado para esta operação de recurso.

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

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
--mi-ua --user-assigned-mi

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.

--no-wait

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

Propriedade Valor
Valor predefinido: False
--tags

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: 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 de assinatura. 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
Valor predefinido: False

az iot adr ns su instance wait

Pré-visualizar

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

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

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O ID de referência de alteração relacionado para esta operação de recurso.

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

Espere até que o Estado de Provisionamento seja Sucedido.

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

Espere até que uma expressão JMESPath personalizada seja avaliada como verdadeira.

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

Espera até que o recurso seja eliminado.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor predefinido: False
--exists

Aguarde até que o recurso exista.

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

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor predefinido: 30
--timeout

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

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

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: 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 de assinatura. 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
Valor predefinido: False