Partilhar via

az scvmm vm extension

  • Referência

Nota

Essa referência faz parte da extensão scvmm para a CLI do Azure (versão 2.15.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az scvmm vm extension . Saiba mais sobre extensões.

Gerencie a extensão vm com scvmm.

Comandos

Name Description Tipo Status
az scvmm vm extension create

A operação para criar a extensão.

 Extensão GA
az scvmm vm extension delete

A operação para excluir a extensão.

 Extensão GA
az scvmm vm extension list

A operação para obter todas as extensões de uma vm que não seja do Azure.

 Extensão GA
az scvmm vm extension show

A operação para obter a extensão.

 Extensão GA
az scvmm vm extension update

A operação para atualizar a extensão.

 Extensão GA

az scvmm vm extension create

A operação para criar a extensão.

az scvmm vm extension create --location
                             --name
                             --resource-group
                             --vm-name
                             [--auto-upgrade-minor {false, true}]
                             [--enable-auto-upgrade {false, true}]
                             [--force-update-tag]
                             [--no-wait]
                             [--protected-settings]
                             [--publisher]
                             [--settings]
                             [--tags]
                             [--type]
                             [--type-handler-version]

Exemplos

Criar uma extensão de VM

az scvmm vm extension create --name contoso-extension --location eastus2euap --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

Parâmetros Obrigatórios

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--name

O nome da extensão vm.

--resource-group -g

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

--vm-name

O nome da vm onde a extensão deve ser criada ou atualizada.

Parâmetros Opcionais

--auto-upgrade-minor

Indique se a extensão deve usar uma versão secundária mais recente, se houver uma disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true.

Valores aceites: false, true
--enable-auto-upgrade

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

Valores aceites: false, true
--force-update-tag

Como o manipulador de extensão deve ser forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada.

--no-wait

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

Default value: False
--protected-settings

A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. Valor esperado: json-string/json-file/@json-file.

--publisher

O nome do editor do manipulador de extensão.

--settings

Json formatou configurações públicas para a extensão. Valor esperado: json-string/json-file/@json-file.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--type

Especifique o tipo de extensão; um exemplo é "CustomScriptExtension".

--type-handler-version

Especifica a versão do manipulador de script.

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
Default value: 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 scvmm vm extension delete

A operação para excluir a extensão.

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

Exemplos

Excluir uma extensão de VM

az scvmm vm extension delete --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

O nome da extensão vm.

--no-wait

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

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

--vm-name

O nome da vm onde a extensão deve ser excluída.

--yes -y

Não solicite confirmação.

Default value: 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
Default value: 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 scvmm vm extension list

A operação para obter todas as extensões de uma vm que não seja do Azure.

az scvmm vm extension list --resource-group
                           --vm-name
                           [--expand]

Exemplos

Obter todas as extensões de VM

az scvmm vm extension list --vm-name contoso-vm --resource-group contoso-rg

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

--vm-name

O nome da vm que contém a extensão.

Parâmetros Opcionais

--expand

A expressão expand a ser aplicada na operação.

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
Default value: 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 scvmm vm extension show

A operação para obter a extensão.

az scvmm vm extension show [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]
                           [--vm-name]

Exemplos

Obter extensão VM

az scvmm vm extension show --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

O nome da extensão vm.

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

--vm-name

O nome da vm que contém a extensão.

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
Default value: 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 scvmm vm extension update

A operação para atualizar a extensão.

az scvmm vm extension update --name
                             --resource-group
                             --vm-name
                             [--auto-upgrade-minor {false, true}]
                             [--enable-auto-upgrade {false, true}]
                             [--force-update-tag]
                             [--no-wait]
                             [--protected-settings]
                             [--publisher]
                             [--settings]
                             [--tags]
                             [--type]
                             [--type-handler-version]

Exemplos

Atualizar uma extensão de VM

az scvmm vm extension update --name contoso-extension --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

Parâmetros Obrigatórios

--name

O nome da extensão vm.

--resource-group -g

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

--vm-name

O nome da vm onde a extensão deve ser criada ou atualizada.

Parâmetros Opcionais

--auto-upgrade-minor

Indique se a extensão deve usar uma versão secundária mais recente, se houver uma disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true.

Valores aceites: false, true
--enable-auto-upgrade

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

Valores aceites: false, true
--force-update-tag

Como o manipulador de extensão deve ser forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada.

--no-wait

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

Default value: False
--protected-settings

A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. Valor esperado: json-string/json-file/@json-file.

--publisher

O nome do editor do manipulador de extensão.

--settings

Json formatou configurações públicas para a extensão. Valor esperado: json-string/json-file/@json-file.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--type

Especifique o tipo de extensão; um exemplo é "CustomScriptExtension".

--type-handler-version

Especifica a versão do manipulador de script.

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