Share via

az vmss extension

  • Referência

Gerencie extensões em um conjunto de escala de VM.

Comandos

Name Description Tipo Estado
az vmss extension delete

Exclua uma extensão de um VMSS.

 Principal GA
az vmss extension image

Encontre as extensões de VM disponíveis para uma assinatura e região.

 Principal GA
az vmss extension image list

Liste as informações sobre as extensões disponíveis.

 Principal GA
az vmss extension image list-names

Liste tipos de imagem de extensão de máquina virtual.

 Principal GA
az vmss extension image list-versions

Liste versões de imagem de extensão de máquina virtual.

 Principal GA
az vmss extension image show

Obtenha uma imagem de extensão de máquina virtual.

 Principal GA
az vmss extension list

Listar extensões associadas a um VMSS.

 Principal GA
az vmss extension set

Adicione uma extensão a um VMSS ou atualize uma extensão existente.

 Principal GA
az vmss extension show

Mostrar detalhes sobre uma extensão VMSS.

 Principal GA
az vmss extension upgrade

Atualize todas as extensões de todas as instâncias do VMSS para a versão mais recente.

 Principal GA

az vmss extension delete

Editar

Exclua uma extensão de um VMSS.

az vmss extension delete --name
                         --resource-group
                         --vmss-name
                         [--no-wait]

Exemplos

Exclua uma extensão de um VMSS. (gerado automaticamente)

az vmss extension delete --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

Parâmetros Obrigatórios

--name -n

Nome da extensão.

--resource-group -g

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

--vmss-name

Nome do conjunto de escalas. Você pode configurar o padrão usando az configure --defaults vmss=<name>.

Parâmetros Opcionais

--no-wait

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

valor predefinido: 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
valor predefinido: 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 vmss extension list

Editar

Listar extensões associadas a um VMSS.

az vmss extension list --resource-group
                       --vmss-name

Exemplos

Listar extensões associadas a um VMSS. (gerado automaticamente)

az vmss extension list --resource-group MyResourceGroup --vmss-name MyVmss

Parâmetros Obrigatórios

--resource-group -g

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

--vmss-name

Nome do conjunto de escalas. Você pode configurar o padrão usando az configure --defaults vmss=<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
valor predefinido: 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 vmss extension set

Editar

Adicione uma extensão a um VMSS ou atualize uma extensão existente.

Obtenha detalhes da extensão em az vmss extension image list.

az vmss extension set --name
                      --publisher
                      --resource-group
                      --vmss-name
                      [--enable-auto-upgrade {false, true}]
                      [--extension-instance-name]
                      [--force-update]
                      [--no-auto-upgrade {false, true}]
                      [--no-auto-upgrade-minor-version {false, true}]
                      [--no-wait]
                      [--protected-settings]
                      [--provision-after-extensions]
                      [--settings]
                      [--version]

Exemplos

Defina uma extensão que depende de duas extensões definidas anteriormente. Ou seja, quando uma instância do VMSS é criada ou recriada, a extensão customScript será provisionada somente depois que todas as extensões das quais ela depende tiverem sido provisionadas. A extensão não precisa depender das outras extensões para configurações de pré-requisito.

az vmss extension set --vmss-name my-vmss --name customScript --resource-group my-group \
    --version 2.0 --publisher Microsoft.Azure.Extensions \
    --provision-after-extensions NetworkWatcherAgentLinux VMAccessForLinux  \
    --settings '{"commandToExecute": "echo testing"}'

Adicione uma extensão e habilite a atualização automática pela plataforma se houver uma versão mais recente da extensão disponível.

az vmss extension set -n extName --publisher publisher --vmss-name my-vmss -g my-group \ --enable-auto-upgrade true

Parâmetros Obrigatórios

--name -n

Nome da extensão.

valor de: az vm extension image list
--publisher

O nome do editor de extensão.

--resource-group -g

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

--vmss-name

Nome do conjunto de escalas. Você pode configurar o padrão usando az configure --defaults vmss=<name>.

Parâmetros Opcionais

--enable-auto-upgrade

Indique que a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível.

valores aceites: false, true
--extension-instance-name

Nome da instância de extensão, que pode ser personalizada. Padrão: nome da extensão.

--force-update

Força a atualização mesmo que a configuração da extensão não tenha sido alterada.

valor predefinido: False
--no-auto-upgrade
Preterido

A opção '--no-auto-upgrade' foi preterida e será removida em uma versão futura. Use '--no-auto-upgrade-minor-version' em vez disso.

Se definido, o serviço de extensão não selecionará ou atualizará automaticamente para a versão secundária mais recente, mesmo que a extensão seja reimplantada.

valores aceites: false, true
valor predefinido: False
--no-auto-upgrade-minor-version

Se definido, o serviço de extensão não selecionará ou atualizará automaticamente para a versão secundária mais recente, mesmo que a extensão seja reimplantada.

valores aceites: false, true
valor predefinido: False
--no-wait

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

valor predefinido: False
--protected-settings

Configurações protegidas no formato JSON para informações confidenciais, como credenciais. Um caminho de arquivo JSON também é aceito.

--provision-after-extensions

Lista separada por espaços de nomes de extensões após a qual esta extensão deve ser provisionada. Essas extensões já devem estar definidas na vm.

--settings

Configurações de extensão no formato JSON. Um caminho de arquivo JSON também é aceito.

--version

A versão da extensão. Para fixar a versão da extensão a esse valor, especifique --no-auto-upgrade-minor-version.

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
valor predefinido: 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 vmss extension show

Editar

Mostrar detalhes sobre uma extensão VMSS.

az vmss extension show --name
                       --resource-group
                       --vmss-name

Exemplos

Mostrar detalhes sobre uma extensão VMSS. (gerado automaticamente)

az vmss extension show --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

Parâmetros Obrigatórios

--name -n

Nome da extensão.

--resource-group -g

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

--vmss-name

Nome do conjunto de escalas. Você pode configurar o padrão usando az configure --defaults vmss=<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
valor predefinido: 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 vmss extension upgrade

Editar

Atualize todas as extensões de todas as instâncias do VMSS para a versão mais recente.

az vmss extension upgrade [--ids]
                          [--name]
                          [--no-wait]
                          [--resource-group]
                          [--subscription]

Exemplos

Atualize todas as extensões para a versão mais recente.

az vmss extension upgrade -g MyResourceGroup -n MyVmss

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do conjunto de escalas. Você pode configurar o padrão usando az configure --defaults vmss=<name>.

--no-wait

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

valor predefinido: False
--resource-group -g

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

--subscription

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

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
valor predefinido: 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.