Compartir a través de


az vmss extension

Administrar extensiones en un conjunto de escalado de máquinas virtuales.

Comandos

Nombre Description Tipo Estado
az vmss extension delete

Elimine una extensión de vmSS.

Core GA
az vmss extension image

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

Core GA
az vmss extension image list

Enumerar la información sobre las extensiones disponibles.

Core GA
az vmss extension image list-names

Enumerar los tipos de imagen de extensión de máquina virtual.

Core GA
az vmss extension image list-versions

Enumerar las versiones de la imagen de extensión de máquina virtual.

Core GA
az vmss extension image show

Obtenga una imagen de extensión de máquina virtual.

Core GA
az vmss extension list

Enumerar extensiones asociadas a vmSS.

Core GA
az vmss extension set

Agregue una extensión a vmSS o actualice una extensión existente.

Core GA
az vmss extension show

Mostrar detalles sobre una extensión VMSS.

Core GA
az vmss extension upgrade

Actualice todas las extensiones de todas las instancias de VMSS a la versión más reciente.

Core GA

az vmss extension delete

Elimine una extensión de vmSS.

az vmss extension delete --name
                         --resource-group
                         --vmss-name
                         [--no-wait]

Ejemplos

Elimine una extensión de vmSS. (autogenerated)

az vmss extension delete --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

Parámetros requeridos

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

--vmss-name

Nombre del conjunto de escalado. Puede configurar el valor predeterminado mediante az configure --defaults vmss=<name>.

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.

--no-wait

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

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

Formato de salida.

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

Enumerar extensiones asociadas a vmSS.

az vmss extension list --resource-group
                       --vmss-name

Ejemplos

Enumerar extensiones asociadas a vmSS. (autogenerated)

az vmss extension list --resource-group MyResourceGroup --vmss-name MyVmss

Parámetros requeridos

--resource-group -g

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

--vmss-name

Nombre del conjunto de escalado. Puede configurar el valor predeterminado mediante az configure --defaults vmss=<name>.

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

Formato de salida.

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

Agregue una extensión a vmSS o actualice una extensión existente.

Obtenga los detalles de la extensión de az vmss extension image list.

az vmss extension set --name
                      --publisher
                      --resource-group
                      --vmss-name
                      [--enable-auto-upgrade {false, true}]
                      [--extension-instance-name]
                      [--force-update]
                      [--no-auto-upgrade {false, true}]
                      [--no-auto-upgrade-minor-version {false, true}]
                      [--no-wait]
                      [--protected-settings]
                      [--provision-after-extensions]
                      [--settings]
                      [--version]

Ejemplos

Establezca una extensión que dependa de dos extensiones establecidas anteriormente. Es decir, cuando se crea o se vuelve a crear una instancia de VMSS, la extensión customScript solo se aprovisionará después de que se hayan aprovisionado todas las extensiones de las que depende. La extensión no necesita depender de las demás extensiones para las configuraciones de requisitos previos.

az vmss extension set --vmss-name my-vmss --name customScript --resource-group my-group \
    --version 2.0 --publisher Microsoft.Azure.Extensions \
    --provision-after-extensions NetworkWatcherAgentLinux VMAccessForLinux  \
    --settings '{"commandToExecute": "echo testing"}'

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 vmss extension set -n extName --publisher publisher --vmss-name my-vmss -g my-group \ --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.

--resource-group -g

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

--vmss-name

Nombre del conjunto de escalado. Puede configurar el valor predeterminado mediante az configure --defaults vmss=<name>.

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.

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

--provision-after-extensions

Lista separada por espacios de nombres de extensión después de los cuales se debe aprovisionar esta extensión. Estas extensiones ya deben establecerse en la máquina virtual.

--settings

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

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

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

Formato de salida.

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

Mostrar detalles sobre una extensión VMSS.

az vmss extension show --name
                       --resource-group
                       --vmss-name

Ejemplos

Mostrar detalles sobre una extensión VMSS. (autogenerated)

az vmss extension show --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

Parámetros requeridos

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

--vmss-name

Nombre del conjunto de escalado. Puede configurar el valor predeterminado mediante az configure --defaults vmss=<name>.

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

Formato de salida.

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 vmss extension upgrade

Actualice todas las extensiones de todas las instancias de VMSS a la versión más reciente.

az vmss extension upgrade [--ids]
                          [--name]
                          [--no-wait]
                          [--resource-group]
                          [--subscription]

Ejemplos

Actualice todas las extensiones a la versión más reciente.

az vmss extension upgrade -g MyResourceGroup -n MyVmss

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.

--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
Grupo de parámetros: Resource Id Arguments
--name -n

Nombre del conjunto de escalado. Puede configurar el valor predeterminado mediante az configure --defaults vmss=<name>.

Propiedad Valor
Grupo de parámetros: 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
Grupo de parámetros: 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
Grupo de parámetros: 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

Formato de salida.

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