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

az vm extension image

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

命令

名称	说明	类型	状态
az vm extension image list	列出有关可用扩展的信息。	核心	GA
az vm extension image list-names	列出可用扩展的名称。	核心	GA
az vm extension image list-versions	列出可用扩展的版本。	核心	GA
az vm extension image show	显示扩展的信息。	核心	GA

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

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--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 [--ids]
                                 [--location]
                                 [--publisher]
                                 [--subscription]

示例

按发布者和位置查找 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')]"

可选参数

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--location -l

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

--publisher --publisher-name -p

映像发布者名称。

--subscription

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

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

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--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 [--filter]
                                    [--ids]
                                    [--location]
                                    [--name]
                                    [--orderby]
                                    [--publisher]
                                    [--subscription]
                                    [--top]

示例

查找 Docker 扩展的可用版本。

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

可选参数

--filter

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

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--location -l

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

--name --type -n

扩展名。

--orderby

$orderby odata 查询选项。

--publisher --publisher-name -p

映像发布者名称。

--subscription

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

--top

$top odata 查询选项。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

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

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--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 [--ids]
                           [--location]
                           [--name]
                           [--publisher]
                           [--subscription]
                           [--version]

示例

显示 CustomScript 扩展版本 2.0.2。

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

显示最新版本的 Docker 扩展。

az vm extension image list-versions --publisher Microsoft.Azure.Extensions -l westus -n DockerExtension --query "[].name" -o tsv | sort | tail -n 1
az vm extension image show -l westus --publisher Microsoft.Azure.Extensions -n DockerExtension --version LatestVersion

可选参数

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--location -l

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

--name --type -n

扩展名。

--publisher --publisher-name -p

映像发布者名称。

--subscription

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

--version

扩展版本。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

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

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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