az scvmm vm extension

Note

This reference is part of the scvmm extension for the Azure CLI (version 2.15.0 or higher). La extensión instalará automáticamente la primera vez que ejecute un comando az scvmm vm extension. Learn more about extensions.

Administre la extensión de máquina virtual con scvmm.

Comandos

Nombre	Description	Tipo	Estado
az scvmm vm extension create	Operación para crear la extensión.	Extension	GA
az scvmm vm extension delete	Operación para eliminar la extensión.	Extension	GA
az scvmm vm extension list	La operación para obtener todas las extensiones de una máquina virtual que no es de Azure.	Extension	GA
az scvmm vm extension show	Operación para obtener la extensión.	Extension	GA
az scvmm vm extension update	Operación para actualizar la extensión.	Extension	GA

az scvmm vm extension create

Operación para crear la extensión.

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]

Ejemplos

Creación de una extensión de máquina virtual

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 requeridos

--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name

Nombre de la extensión de máquina virtual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--vm-name

Nombre de la máquina virtual donde se debe crear o actualizar la extensión.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auto-upgrade-minor

Indica si la extensión debe usar una versión secundaria más reciente si hay una disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true.

Propiedad	Valor
Valores aceptados:	false, true

--enable-auto-upgrade

Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente disponible.

Propiedad	Valor
Valores aceptados:	false, true

--force-update-tag

Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--protected-settings

La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. Valor esperado: json-string/json-file/@json-file.

--publisher

Nombre del publicador de controladores de extensión.

--settings

Configuración pública con formato JSON para la extensión. Valor esperado: json-string/json-file/@json-file.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--type

Especifique el tipo de la extensión; Un ejemplo es "CustomScriptExtension".

--type-handler-version

Especifica la versión del controlador de script.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az scvmm vm extension delete

Operación para eliminar la extensión.

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

Ejemplos

Eliminación de una extensión de máquina virtual

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Parameter group:	Resource Id Arguments

--name

Nombre de la extensión de máquina virtual.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--vm-name

Nombre de la máquina virtual donde se debe eliminar la extensión.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az scvmm vm extension list

La operación para obtener todas las extensiones de una máquina virtual que no es de Azure.

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

Ejemplos

Obtención de todas las extensiones de máquina virtual

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

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--vm-name

Nombre de la máquina virtual que contiene la extensión.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand

Expresión expand que se va a aplicar en la operación.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az scvmm vm extension show

Operación para obtener la extensión.

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

Ejemplos

Obtención de la extensión de máquina virtual

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Propiedad	Valor
Parameter group:	Resource Id Arguments

--name

Nombre de la extensión de máquina virtual.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Parameter group:	Resource Id Arguments

--vm-name

Nombre de la máquina virtual que contiene la extensión.

Propiedad	Valor
Parameter group:	Resource Id Arguments

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az scvmm vm extension update

Operación para actualizar la extensión.

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]

Ejemplos

Actualización de una extensión de máquina virtual

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 requeridos

--name

Nombre de la extensión de máquina virtual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--vm-name

Nombre de la máquina virtual donde se debe crear o actualizar la extensión.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auto-upgrade-minor

Propiedad	Valor
Valores aceptados:	false, true

--enable-auto-upgrade

Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente disponible.

Propiedad	Valor
Valores aceptados:	false, true

--force-update-tag

Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--protected-settings

La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. Valor esperado: json-string/json-file/@json-file.

--publisher

Nombre del publicador de controladores de extensión.

--settings

Configuración pública con formato JSON para la extensión. Valor esperado: json-string/json-file/@json-file.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--type

Especifique el tipo de la extensión; Un ejemplo es "CustomScriptExtension".

--type-handler-version

Especifica la versión del controlador de script.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

Compartir a través de

az scvmm vm extension

Comandos

az scvmm vm extension create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az scvmm vm extension delete

Ejemplos

Parámetros opcionales

az scvmm vm extension list

Ejemplos

Parámetros requeridos

Parámetros opcionales

az scvmm vm extension show

Ejemplos

Parámetros opcionales

az scvmm vm extension update

Ejemplos

Parámetros requeridos

Parámetros opcionales

Comentarios