你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az vm extension image

查找订阅和区域的可用 VM 扩展。

命令

az vm extension image list

列出有关可用扩展的信息。

az vm extension image list-names

列出可用扩展的名称。

az vm extension image list-versions

列出可用扩展的版本。

az vm extension image show

显示扩展的信息。

az vm extension image list

列出有关可用扩展的信息。

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

示例

列出扩展的唯一发布者。

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

在名称中查找具有“Docker”的扩展。

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

列出发布者名称以“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

可选参数

--latest

仅显示最新版本。

默认值: False
--location -l

图像位置。

--name -n

映像名称。

--publisher -p

映像发布者名称。

--version

扩展版本。

az vm extension image list-names

列出可用扩展的名称。

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

示例

按发布者和位置查找 Docker 扩展。

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

按发布者和位置查找 CustomScript 扩展。

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

必需参数

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--publisher -p

映像发布者名称。

az vm extension image list-versions

列出可用扩展的版本。

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

示例

查找 Docker 扩展的可用版本。

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

必需参数

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--name -n

扩展名。

--publisher -p

映像发布者名称。

可选参数

--filter

要应用于操作的筛选器。 默认值为 None。

--orderby

$orderby odata 查询选项。

--top

$top odata 查询选项。

az vm extension image show

显示扩展的信息。

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

示例

显示 CustomScript 扩展版本 2.0.2。

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

显示最新版本的 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}

必需参数

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--name -n

扩展名。

--publisher -p

映像发布者名称。

--version

扩展版本。