az vm extension image

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

Comandos

az vm extension image list	Enumere la información sobre las extensiones disponibles.
az vm extension image list-names	Enumere los nombres de las extensiones disponibles.
az vm extension image list-versions	Enumere las versiones de las extensiones disponibles.
az vm extension image show	Mostrar información de una extensión.

az vm extension image list

Enumere la información sobre las extensiones disponibles.

az vm extension image list [--latest]
                           [--location]
                           [--name]
                           [--publisher]
                           [--version]

Ejemplos

Enumere los publicadores únicos para las extensiones.

az vm extension image list --query "[].publisher" -o tsv | sort -u

Busque extensiones con "Docker" en el nombre.

az vm extension image list --query "[].name" -o tsv | sort -u | grep Docker

Enumera los nombres de extensión en los que el nombre del publicador comienza por "Microsoft.Azure.App".

az vm extension image list --query \
    "[?starts_with(publisher, 'Microsoft.Azure.App')].publisher" \
    -o tsv | sort -u | xargs -I{} az vm extension image list-names --publisher {} -l westus

Parámetros opcionales

--latest

Mostrar solo la versión más reciente.

--location -l

Ubicación de la imagen.

--name -n

Nombre de la imagen.

--publisher -p

Nombre del publicador de imágenes.

--version

Versión de 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.

--query

Cadena de consulta de JMESPath. Para obtener más información y ejemplos, vea 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 image list-names

Enumere los nombres de las extensiones disponibles.

az vm extension image list-names --location
                                 --publisher

Ejemplos

Busque extensiones de Docker por publicador y ubicación.

az vm extension image list-names --publisher Microsoft.Azure.Extensions \
    -l westus --query "[?starts_with(name, 'Docker')]"

Busque extensiones de CustomScript por publicador y ubicación.

az vm extension image list-names --publisher Microsoft.Azure.Extensions \
    -l westus --query "[?starts_with(name, 'Custom')]"

Parámetros requeridos

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--publisher -p

Nombre del publicador de imágenes.

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.

--query

Cadena de consulta de JMESPath. Para obtener más información y ejemplos, vea 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 image list-versions

Enumere las versiones de las extensiones disponibles.

az vm extension image list-versions --location
                                    --name
                                    --publisher
                                    [--filter]
                                    [--orderby]
                                    [--top]

Ejemplos

Busque las versiones disponibles para la extensión de Docker.

az vm extension image list-versions --publisher Microsoft.Azure.Extensions \
    -l westus -n DockerExtension -otable

Parámetros requeridos

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name -n

Nombre de la extensión.

--publisher -p

Nombre del publicador de imágenes.

Parámetros opcionales

--filter

Filtro que se va a aplicar en la operación. El valor predeterminado es Ninguno.

--orderby

La opción de consulta $orderby odata.

--top

La opción de consulta $top odata.

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.

--query

Cadena de consulta de JMESPath. Para obtener más información y ejemplos, vea 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 image show

Mostrar información de una extensión.

az vm extension image show --location
                           --name
                           --publisher
                           --version

Ejemplos

Muestra la versión 2.0.2 de la extensión CustomScript.

az vm extension image show -l westus -n CustomScript \
  --publisher Microsoft.Azure.Extensions --version 2.0.2

Muestra la versión más reciente de la extensión de Docker.

publisher=Microsoft.Azure.Extensions
extension=DockerExtension
location=westus

latest=$(az vm extension image list-versions \
  --publisher ${publisher} -l ${location} -n ${extension} \
  --query "[].name" -o tsv | sort | tail -n 1)

az vm extension image show -l ${location} \
  --publisher ${publisher} -n ${extension} --version ${latest}

Parámetros requeridos

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name -n

Nombre de la extensión.

--publisher -p

Nombre del publicador de imágenes.

--version

Versión de 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.

--query

Cadena de consulta de JMESPath. Para obtener más información y ejemplos, vea 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.