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
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
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.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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
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 se tornar obrigatórios para que o comando seja executado com sucesso.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
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. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
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 |
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.
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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
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 se tornar obrigatórios para que o comando seja executado com sucesso.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
A ID de referência de alteração relacionada para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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
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 Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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
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 se tornar obrigatórios para que o comando seja executado com sucesso.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
A ID de referência de alteração relacionada para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
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 |
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.
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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
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 se tornar obrigatórios para que o comando seja executado com sucesso.
Adquirir um token Azure Policy automaticamente para essa operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
A ID de referência de alteração relacionada para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Aguarde até que provisioningState seja bem-sucedido.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Aguarde até que uma expressão JMESPath personalizada seja avaliada como true.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
Aguarde até que o recurso seja excluído.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Aguarde até que o recurso exista.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Intervalo de sondagem em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | 30 |
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 |
Aguarde até que provisioningState seja bem-sucedido.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |