az vm extension

Administrar extensiones en máquinas virtuales.

Las extensiones son aplicaciones pequeñas que proporcionan tareas de automatización y configuración posteriores a la implementación en máquinas virtuales de Azure. Por ejemplo, si una máquina virtual necesita que se instale software, protección antivirus o configuración de Docker, se puede usar una extensión de máquina virtual para completar estas tareas. Las extensiones pueden empaquetar con una nueva implementación de máquina virtual o se pueden ejecutar en cualquier sistema existente.

Comandos

Nombre Description Tipo Estado
az vm extension delete

Operación de eliminación para eliminar la extensión.

Principal GA
az vm extension image

Busque las extensiones de máquina virtual disponibles para una suscripción y región.

Principal GA
az vm extension image list

Enumerar la información sobre las extensiones disponibles.

Principal GA
az vm extension image list-names

Enumera los nombres de las extensiones disponibles.

Principal GA
az vm extension image list-versions

Enumere las versiones de las extensiones disponibles.

Principal GA
az vm extension image show

Mostrar información de una extensión.

Principal GA
az vm extension list

Enumere las extensiones asociadas a una máquina virtual.

Principal GA
az vm extension set

Establezca extensiones para una máquina virtual.

Principal GA
az vm extension show

Mostrar información sobre las extensiones conectadas a una máquina virtual.

Principal GA
az vm extension wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de una extensión de máquina virtual.

Principal GA

az vm extension delete

Operación de eliminación para eliminar la extensión.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

Ejemplos

Use un nombre de máquina virtual y una extensión para eliminar una extensión de una máquina virtual.

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

Elimine extensiones con identificadores que contengan la cadena "MyExtension" de una máquina virtual.

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

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 --vm-extension-name -n

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

--no-wait

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

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--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. Puede configurar el valor predeterminado mediante az configure --defaults vm=<name>.

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 vm extension list

Enumere las extensiones asociadas a una máquina virtual.

az vm extension list [--ids]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Ejemplos

Enumerar las extensiones adjuntas a una máquina virtual con nombre.

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

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

--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. Puede configurar el valor predeterminado mediante az configure --defaults vm=<name>.

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 vm extension set

Establezca extensiones para una máquina virtual.

Obtenga los detalles de la extensión 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]
                    [--subscription]
                    [--version]
                    [--vm-name]

Ejemplos

Agregue una cuenta de usuario a una máquina virtual Linux.

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 ..."}'

Agregue una extensión customScript a las máquinas virtuales especificadas por --ids.

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

Agregue una extensión y habilite la actualización automática por la plataforma si hay una versión más reciente de la extensión disponible.

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

Parámetros requeridos

--name -n

Nombre de la extensión.

valor de: az vm extension image list
--publisher

Nombre del publicador de extensiones.

Parámetros opcionales

--enable-auto-upgrade

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

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

Nombre de la instancia de extensión, que se puede personalizar. Valor predeterminado: nombre de la extensión.

--force-update

Forzar la actualización incluso si la configuración de la extensión no ha cambiado.

valor predeterminado: False
--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".

--no-auto-upgrade
Obsoleto

La opción "--no-auto-upgrade" está en desuso y se quitará en una versión futura. En su lugar, use "--no-auto-upgrade-minor-version".

Si se establece, el servicio de extensión no seleccionará o actualizará automáticamente a la versión secundaria más reciente, incluso si la extensión se vuelve a implementar.

valores aceptados: false, true
valor predeterminado: False
--no-auto-upgrade-minor-version

Si se establece, el servicio de extensión no seleccionará o actualizará automáticamente a la versión secundaria más reciente, incluso si la extensión se vuelve a implementar.

valores aceptados: false, true
valor predeterminado: False
--no-wait

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

valor predeterminado: False
--protected-settings

Configuración protegida en formato JSON para información confidencial, como las credenciales. También se acepta una ruta de acceso al archivo JSON.

--resource-group -g

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

--settings

Configuración de extensión en formato JSON. También se acepta una ruta de acceso al archivo JSON.

--subscription

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

--version

Versión de la extensión. Para anclar la versión de la extensión a este valor, especifique --no-auto-upgrade-minor-version.

--vm-name

Nombre de la máquina virtual. Puede configurar el valor predeterminado mediante az configure --defaults vm=<name>.

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 vm extension show

Mostrar información sobre las extensiones conectadas a una máquina virtual.

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

Ejemplos

Use el nombre de la máquina virtual y el nombre de la extensión para mostrar las extensiones asociadas a una máquina virtual.

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

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

--instance-view

Vista de instancia de una extensión de máquina virtual.

valor predeterminado: False
--name -n

Nombre de la extensión.

--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. Puede configurar el valor predeterminado mediante az configure --defaults vm=<name>.

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 vm extension wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de una extensión de máquina virtual.

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

Ejemplos

Coloque la CLI en un estado de espera hasta que se cumpla una condición de una extensión de máquina virtual. (generado automáticamente)

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

Coloque la CLI en un estado de espera hasta que se cumpla una condición de una extensión de máquina virtual. (generado automáticamente)

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

Coloque la CLI en un estado de espera hasta que se cumpla una condición de una extensión de máquina virtual. (generado automáticamente)

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

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

valor predeterminado: False
--exists

Espere hasta que exista el recurso.

valor predeterminado: False
--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".

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--name -n

Nombre de la extensión.

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

--timeout

Espera máxima en segundos.

valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

valor predeterminado: False
--vm-name

Nombre de la máquina virtual. Puede configurar el valor predeterminado mediante az configure --defaults vm=<name>.

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.