Compartilhar via


az vmss extension

Gerenciar extensões em um conjunto de dimensionamento de VM.

Comandos

Nome Description Tipo Status
az vmss extension delete

Exclua uma extensão de um VMSS.

Núcleo GA
az vmss extension image

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

Núcleo GA
az vmss extension image list

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

Núcleo GA
az vmss extension image list-names

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

Núcleo GA
az vmss extension image list-versions

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

Núcleo GA
az vmss extension image show

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

Núcleo GA
az vmss extension list

Listar extensões associadas a um VMSS.

Núcleo GA
az vmss extension set

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

Núcleo GA
az vmss extension show

Mostrar detalhes sobre uma extensão VMSS.

Núcleo GA
az vmss extension upgrade

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

Núcleo GA

az vmss extension delete

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 Exigidos

--name -n

Nome da extensão.

--resource-group -g

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

Parâmetros Opcionais

--no-wait

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

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az vmss extension list

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 Exigidos

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az vmss extension set

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 Exigidos

--name -n

Nome da extensão.

Valor de: az vm extension image list
--publisher

O nome do editor da extensão.

--resource-group -g

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

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 aceitos: 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 padrão: False
--no-auto-upgrade
Preterido

A opção '--no-auto-upgrade' foi preterida e será removida em uma versão futura. Em vez disso, use '--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 se a extensão for reimplantada.

Valores aceitos: false, true
Valor padrão: 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 se a extensão for reimplantada.

Valores aceitos: false, true
Valor padrão: False
--no-wait

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

Valor padrão: 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ço de nomes de extensão após a qual essa 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 Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az vmss extension show

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 Exigidos

--name -n

Nome da extensão.

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az vmss extension upgrade

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

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. 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>o .

--no-wait

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

Valor padrão: False
--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.