Partilhar via


az vmss extension

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

Comandos

Name Description Tipo Status
az vmss extension delete

Exclua uma extensão de um VMSS.

Core disponibilidade geral
az vmss extension image

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

Core disponibilidade geral
az vmss extension image list

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

Core disponibilidade geral
az vmss extension image list-names

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

Core disponibilidade geral
az vmss extension image list-versions

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

Core disponibilidade geral
az vmss extension image show

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

Core disponibilidade geral
az vmss extension list

Listar extensões associadas a um VMSS.

Core disponibilidade geral
az vmss extension set

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

Core disponibilidade geral
az vmss extension show

Mostrar detalhes sobre uma extensão VMSS.

Core disponibilidade geral
az vmss extension upgrade

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

Core disponibilidade geral

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. (autogenerated)

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

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

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.

--no-wait

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

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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 da subscrição. 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
Default value: False

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. (autogenerated)

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

Parâmetros Obrigatórios

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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 da subscrição. 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
Default value: False

az vmss extension set

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

Obtenha detalhes da extensão de 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.

Propriedade Valor
Valor de: az vm extension image list
--publisher

O nome do editor de 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>.

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.

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

Propriedade Valor
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.

Propriedade Valor
Default value: 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.

Propriedade Valor
Default value: False
Valores aceites: false, true
--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.

Propriedade Valor
Default value: False
Valores aceites: false, true
--no-wait

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

Propriedade Valor
Default value: 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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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 da subscrição. 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
Default value: False

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. (autogenerated)

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

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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 da subscrição. 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
Default value: False

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

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.

--ids

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--no-wait

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

Propriedade Valor
Default value: False
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: 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.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False