通过

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

az vm extension image

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

命令

名称 说明 类型 Status
az vm extension image list

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

 Core GA
az vm extension image list-names

列出可用扩展的名称。

 Core GA
az vm extension image list-versions

列出可用扩展的版本。

 Core GA
az vm extension image show

显示扩展的信息。

 Core 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

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

属性 值
默认值: False

az vm extension image list-names

编辑

列出可用扩展的名称。

az vm extension image list-names [--ids]
                                 [--location]
                                 [--publisher --publisher-name]
                                 [--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（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性 值
参数组: Resource Id Arguments
--location -l

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

属性 值
参数组: Resource Id Arguments
--publisher --publisher-name -p

映像发布者名称。

属性 值
参数组: Resource Id Arguments
--subscription

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

属性 值
参数组: Resource Id Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

属性 值
默认值: False

az vm extension image list-versions

编辑

列出可用扩展的版本。

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

示例

查找 Docker 扩展的可用版本。

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

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--filter

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

--ids

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

属性 值
参数组: Resource Id Arguments
--location -l

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

属性 值
参数组: Resource Id Arguments
--name --type -n

扩展的名称。

属性 值
参数组: Resource Id Arguments
--orderby

$orderby odata 查询选项。

--publisher --publisher-name -p

映像发布者名称。

属性 值
参数组: Resource Id Arguments
--subscription

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

属性 值
参数组: Resource Id Arguments
--top

$top odata 查询选项。

全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

属性 值
默认值: False

az vm extension image show

编辑

显示扩展的信息。

az vm extension image show [--ids]
                           [--location]
                           [--name --type]
                           [--publisher --publisher-name]
                           [--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（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性 值
参数组: Resource Id Arguments
--location -l

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

属性 值
参数组: Resource Id Arguments
--name --type -n

扩展的名称。

属性 值
参数组: Resource Id Arguments
--publisher --publisher-name -p

映像发布者名称。

属性 值
参数组: Resource Id Arguments
--subscription

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

属性 值
参数组: Resource Id Arguments
--version

扩展版本。

属性 值
参数组: Resource Id Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

属性 值
默认值: False