Compartir a través de

az connectedvmware vm extension

  • Referencia

Nota:

Esta referencia forma parte de la extensión connectedvmware para la CLI de Azure (versión 2.0.67 o posterior). La extensión 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.

 Extensión GA
az connectedvmware vm extension delete

Operación para eliminar la extensión.

 Extensión GA
az connectedvmware vm extension list

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

 Extensión GA
az connectedvmware vm extension show

Operación para obtener la extensión.

 Extensión GA
az connectedvmware vm extension update

Operación para actualizar la extensión.

 Extensión 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 -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

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

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.

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 hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--protected-settings

La extensión puede contener configuraciones protegidas Configuración o protegidas Configuración FromKeyVault 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--name

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

--no-wait

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

Valor predeterminado: False
--resource-group -g

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

--subscription

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

--vm-name

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

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

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

--expand

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

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

--subscription

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

--vm-name

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

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

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

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.

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 hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--protected-settings

La extensión puede contener configuraciones protegidas Configuración o protegidas Configuración FromKeyVault 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.