az connectedvmware vm extension
Note
Esta referencia forma parte de la extensión connectedvmware para la CLI de Azure (versión 2.0.67 o posterior). La extensión se instalará automáticamente la primera vez que ejecute un comando az connectedvmware vm extension. Obtenga más información sobre las extensiones.
Administre la extensión de máquina virtual con connectedvmware.
Comandos
| Nombre | Description | Tipo | Estado |
|---|---|---|---|
| az connectedvmware vm extension create |
Operación para crear la extensión. |
Extension | GA |
| az connectedvmware vm extension delete |
Operación para eliminar la extensión. |
Extension | GA |
| az connectedvmware vm extension list |
La operación para obtener todas las extensiones de una máquina virtual que no es de Azure. |
Extension | GA |
| az connectedvmware vm extension show |
Operación para obtener la extensión. |
Extension | GA |
| az connectedvmware vm extension update |
Operación para actualizar la extensión. |
Extension | GA |
az connectedvmware vm extension create
Operación para crear la extensión.
az connectedvmware 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 connectedvmware vm extension create --name "CustomScriptExtension" --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 "vm name" --resource-group "myResourceGroup"
Parámetros requeridos
Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre de la extensión de máquina virtual.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre de la máquina virtual donde se debe crear o actualizar la extensión.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
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 |
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 |
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 espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. Valor esperado: json-string/json-file/@json-file.
Nombre del publicador de controladores de extensión.
Configuración pública con formato JSON para la extensión. Valor esperado: json-string/json-file/@json-file.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Especifique el tipo de la extensión; Un ejemplo es "CustomScriptExtension".
Especifica la versión del controlador de script.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az connectedvmware vm extension delete
Operación para eliminar la extensión.
az connectedvmware 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 connectedvmware vm extension delete --name "vm extension name" --vm-name "vm name" --resource-group "myResourceGroup"
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
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 |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre de la extensión de máquina virtual.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
No espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre de la máquina virtual donde se debe eliminar la extensión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az connectedvmware vm extension list
La operación para obtener todas las extensiones de una máquina virtual que no es de Azure.
az connectedvmware vm extension list --resource-group
--vm-name
[--expand]
Ejemplos
Obtención de todas las extensiones de máquina virtual
az connectedvmware vm extension list --vm-name "vm name" --resource-group "myResourceGroup"
Parámetros requeridos
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre de la máquina virtual que contiene la extensión.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Expresión expand que se va a aplicar en la operación.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az connectedvmware vm extension show
Operación para obtener la extensión.
az connectedvmware vm extension show [--ids]
[--name]
[--resource-group]
[--subscription]
[--vm-name]
Ejemplos
Obtención de la extensión de máquina virtual
az connectedvmware vm extension show --name "CustomScriptExtension" --vm-name "vm name" --resource-group "myResourceGroup"
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
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 |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre de la extensión de máquina virtual.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Nombre de la máquina virtual que contiene la extensión.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az connectedvmware vm extension update
Operación para actualizar la extensión.
az connectedvmware 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 connectedvmware vm extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version "1.10" --vm-name "vm name" --resource-group "myResourceGroup"
Parámetros requeridos
Nombre de la extensión de máquina virtual.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre de la máquina virtual donde se debe crear o actualizar la extensión.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
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 |
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 |
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 espere a que finalice la operación de ejecución prolongada.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. Valor esperado: json-string/json-file/@json-file.
Nombre del publicador de controladores de extensión.
Configuración pública con formato JSON para la extensión. Valor esperado: json-string/json-file/@json-file.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Especifique el tipo de la extensión; Un ejemplo es "CustomScriptExtension".
Especifica la versión del controlador de script.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |