你当前正在访问 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

扩展版本。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

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

映像发布者名称。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

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 查询选项。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

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

扩展版本。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。