VM extension images - az vm extension image

Find the available VM extensions for your subscription and region.

Commands

az vm extension image list Vm extension image list.
az vm extension image list-names Gets a list of virtual machine extension image types.
az vm extension image list-versions Gets a list of virtual machine extension image versions.
az vm extension image show Gets a virtual machine extension image.

az vm extension image list

Vm extension image list.

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

Examples

List the unique publishers for extensions.

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

Find extensions with Docker in the name.

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

List extension names where publisher name starts with "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

Optional Parameters

--latest

Show the latest version only.

--location -l

Image location.

--name -n

Image name.

--publisher -p

Image publisher name.

--version

Extension version.

az vm extension image list-names

Gets a list of virtual machine extension image types.

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

Examples

Find the Docker extensions by publisher and location.

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

Find the CustomScript extensions by publisher and location.

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

Required Parameters

--location -l

Location. You can configure the default location using az configure --defaults location=.

--publisher -p

Image publisher name.

az vm extension image list-versions

Gets a list of virtual machine extension image versions.

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

Examples

Find the available versions for the Docker extension.

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

Required Parameters

--location -l

Location. You can configure the default location using az configure --defaults location=.

--name -n

Name of the extension.

--publisher -p

Image publisher name.

Optional Parameters

--filter

The filter to apply on the operation.

--orderby
--top

az vm extension image show

Gets a virtual machine extension image.

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

Examples

Show the CustomScript extension version 2.0.2.

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

Show the latest version of the Docker extension.

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}

Required Parameters

--location -l

Location. You can configure the default location using az configure --defaults location=.

--name -n

Name of the extension.

--publisher -p

Image publisher name.

--version

Extension version.