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 requiere instalación de 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 se pueden agrupar con una nueva implementación de máquina virtual o ejecutarse en cualquier sistema existente.

Comandos

Nombre	Description	Tipo	Estado
az vm extension delete	Operación de eliminación para eliminar la extensión.	Core	GA
az vm extension image	Busque las extensiones de máquina virtual disponibles para una suscripción y región.	Core	GA
az vm extension image list	Enumerar la información sobre las extensiones disponibles.	Core	GA
az vm extension image list-names	Enumera los nombres de las extensiones disponibles.	Core	GA
az vm extension image list-versions	Enumere las versiones de las extensiones disponibles.	Core	GA
az vm extension image show	Mostrar información de una extensión.	Core	GA
az vm extension list	Enumere las extensiones asociadas a una máquina virtual.	Core	GA
az vm extension set	Establezca extensiones para una máquina virtual.	Core	GA
az vm extension show	Mostrar información sobre las extensiones conectadas a una máquina virtual.	Core	GA
az vm extension wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición.	Core	GA

az vm extension delete

Editar

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

az vm extension delete [--ids]
                       [--name --vm-extension-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

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

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

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

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

Editar

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

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

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

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

Editar

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.

Propiedad	Valor
Valor de:	az vm extension image list

--publisher

Nombre del publicador de extensiones.

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.

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

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

Propiedad	Valor
Valor predeterminado:	False

--ids

Propiedad	Valor
Parameter group:	Resource Id Arguments

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

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

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

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

--no-wait

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

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

Propiedad	Valor
Parameter group:	Resource Id Arguments

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

Propiedad	Valor
Parameter group:	Resource Id Arguments

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

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

Editar

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

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

--instance-view

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

Propiedad	Valor
Valor predeterminado:	False

--name -n

Nombre de la extensión.

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

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

Editar

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

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

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.

--created

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

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	False

--custom

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

Propiedad	Valor
Parameter group:	Wait Condition Arguments

--deleted

Espere hasta que se elimine.

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	False

--exists

Espere hasta que exista el recurso.

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	False

--expand

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

--ids

Propiedad	Valor
Parameter group:	Resource Id Arguments

--interval

Intervalo de sondeo en segundos.

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	30

--name --vm-extension-name -n

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

--timeout

Espera máxima en segundos.

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	3600

--updated

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

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	False

--vm-name

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

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

Compartir a través de

az vm extension

Comandos

az vm extension delete

Ejemplos

Parámetros opcionales

az vm extension list

Ejemplos

Parámetros opcionales

az vm extension set

Ejemplos

Parámetros requeridos

Parámetros opcionales

az vm extension show

Ejemplos

Parámetros opcionales

az vm extension wait

Parámetros opcionales

Comentarios