az vm extension

Gerir extensões em VMs.

As extensões são pequenas aplicações que fornecem tarefas de configuração e automatização pós-implantação em máquinas virtuais Azure. Por exemplo, se uma máquina virtual necessitar de instalação de software, proteção antivírus ou configuração docker, uma extensão VM pode ser usada para completar estas tarefas. As extensões podem ser agregadas com uma nova colocação de máquina virtual ou funcionar contra qualquer sistema existente.

Comandos

az vm extension delete

Remova uma extensão anexada a um VM.

az vm extension image

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

az vm extension image list

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

az vm extension image list-names

Listar os nomes das extensões disponíveis.

az vm extension image list-versions

Listar as versões para extensões disponíveis.

az vm extension image show

Mostrar informações para uma extensão.

az vm extension list

Listar as extensões anexas a um VM.

az vm extension set

Definir extensões para um VM.

az vm extension show

Mostrar informações sobre extensões anexadas a um VM.

az vm extension wait

Coloque o CLI num estado de espera até que seja satisfeita uma condição de extensão da máquina virtual.

az vm extension delete

Remova uma extensão anexada a um VM.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--vm-name]

Exemplos

Utilize um nome VM e uma extensão para eliminar uma extensão de um VM.

az vm extension delete -g MyResourceGroup --vm-name MyVm -n extension_name

Elimine as extensões com IDs que contenham a cadeia "MyExtension" de um VM.

az vm extension delete --ids \
    $(az resource list --query "[?contains(name, 'MyExtension')].id" -o tsv)

Parâmetros Opcionais

--ids

Um ou mais IDs de recursos (espaço-delimitado). Deve ser um ID completo de recursos contendo todas as informações dos argumentos de "Identificação de Recursos". Deve fornecer ou ids ou outros argumentos de "Identificação de Recursos".

--name -n

O nome da extensão.

--no-wait

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

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name>.

--vm-name

O nome da Máquina Virtual. Pode configurar o padrão utilizando az configure --defaults vm=<name>.

az vm extension list

Listar as extensões anexas a um VM.

az vm extension list --resource-group
                     --vm-name

Exemplos

Lista de extensões anexas a um VM nomeado.

az vm extension list -g MyResourceGroup --vm-name MyVm

Parâmetros Obrigatórios

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name>.

--vm-name

O nome da Máquina Virtual. Pode configurar o padrão utilizando az configure --defaults vm=<name>.

az vm extension set

Definir extensões para um VM.

Obtenha detalhes da extensão a partir de az vm extension image list.

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

Exemplos

Adicione uma conta de utilizador a um Linux VM.

az vm extension set -n VMAccessForLinux --publisher Microsoft.OSTCExtensions --version 1.4 \
    --vm-name MyVm --resource-group MyResourceGroup \
    --protected-settings '{"username":"user1", "ssh_key":"ssh_rsa ..."}'

Adicione uma extensão personalizadascript ao VM(s) especificado por ids.

az vm extension set -n customScript --publisher Microsoft.Azure.Extensions --ids {vm_id}

Adicione uma extensão e permita o upgrade automático pela plataforma se houver uma versão mais recente da extensão disponível.

az vm extension set -n extName --publisher publisher --vm-name MyVM -g MyResourceGroup \
--enable-auto-upgrade true

Parâmetros Obrigatórios

--name -n

O nome da extensão.

valor de: az vm extension image list
--publisher

O nome da editora de extensão.

Parâmetros Opcionais

--enable-auto-upgrade

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

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

Nome da extensão, que pode ser personalizado. Predefinição: nome da extensão.

--force-update

Force a atualizar mesmo que a configuração da extensão não tenha mudado.

--ids

Um ou mais IDs de recursos (espaço-delimitado). Deve ser um ID completo de recursos contendo todas as informações dos argumentos de "Identificação de Recursos". Deve fornecer ou ids ou outros argumentos de "Identificação de Recursos".

--no-auto-upgrade

Se for definido, o serviço de extensão não irá automaticamente escolher ou atualizar para a versão menor mais recente, mesmo que a extensão seja redistribuída.

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

Se for definido, o serviço de extensão não irá automaticamente escolher ou atualizar para a versão menor mais recente, mesmo que a extensão seja redistribuída.

valores aceites: false, true
--no-wait

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

--protected-settings

Definições protegidas no formato JSON para informações sensíveis como credenciais. Um caminho de arquivo JSON também é aceite.

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name>.

--settings

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

--version

A versão da extensão. Para fixar a versão de extensão a este valor, por favor especifique -- sem atualização automática-versão menor.

--vm-name

O nome da Máquina Virtual. Pode configurar o padrão utilizando az configure --defaults vm=<name>.

az vm extension show

Mostrar informações sobre extensões anexadas a um VM.

az vm extension show [--expand]
                     [--ids]
                     [--instance-view]
                     [--name]
                     [--resource-group]
                     [--vm-name]

Exemplos

Utilize o nome vm e o nome da extensão para mostrar as extensões anexas a um VM.

az vm extension show -g MyResourceGroup --vm-name MyVm -n extension_name

Parâmetros Opcionais

--expand

A expressão de expansão para aplicar na operação.

--ids

Um ou mais IDs de recursos (espaço-delimitado). Deve ser um ID completo de recursos contendo todas as informações dos argumentos de "Identificação de Recursos". Deve fornecer ou ids ou outros argumentos de "Identificação de Recursos".

--instance-view

A visão de uma extensão de máquina virtual.

--name -n

O nome da extensão.

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name>.

--vm-name

O nome da Máquina Virtual. Pode configurar o padrão utilizando az configure --defaults vm=<name>.

az vm extension wait

Coloque o CLI num estado de espera até que seja satisfeita uma condição de extensão da máquina virtual.

az vm extension wait [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--expand]
                     [--ids]
                     [--interval]
                     [--name]
                     [--resource-group]
                     [--timeout]
                     [--updated]
                     [--vm-name]

Exemplos

Coloque o CLI num estado de espera até que seja satisfeita uma condição de extensão da máquina virtual. (autogerado)

az vm extension wait --created --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Coloque o CLI num estado de espera até que seja satisfeita uma condição de extensão da máquina virtual. (autogerado)

az vm extension wait --exists --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Coloque o CLI num estado de espera até que seja satisfeita uma condição de extensão da máquina virtual. (autogerado)

az vm extension wait --ids @- --name MyExtension --subscription MySubscription --updated --vm-name MyVm

Parâmetros Opcionais

--created

Aguarde até ser criado com o "Estado de provisionamento" em 'Bem sucedido'.

--custom

Aguarde até que a condição satisfaça uma consulta personalizada do JMESPath. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere até apagar.

--exists

Espere até que o recurso exista.

--expand

A expressão de expansão para aplicar na operação.

--ids

Um ou mais IDs de recursos (espaço-delimitado). Deve ser um ID completo de recursos contendo todas as informações dos argumentos de "Identificação de Recursos". Deve fornecer ou ids ou outros argumentos de "Identificação de Recursos".

--interval

Intervalo de sondagens em segundos.

valor predefinido: 30
--name -n

O nome da extensão.

--resource-group -g

o nome do grupo de recursos. Pode configurar o grupo predefinido utilizando az configure --defaults group=<name>.

--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

Aguarde até ser atualizado com o Estado de Provisionamento em 'Bem sucedido'.

--vm-name

O nome da Máquina Virtual. Pode configurar o padrão utilizando az configure --defaults vm=<name>.