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

az image builder output

管理映像生成器模板输出分发服务器。

自定义映像可以分发为托管映像、共享映像库中的共享映像（SIG）或 VHD Blob。

命令

名称	说明	类型	Status
az image builder output add	将映像生成器输出分发服务器添加到映像生成器模板。	核心	GA
az image builder output clear	从映像生成器模板中删除所有映像生成器输出分发服务器。	核心	GA
az image builder output remove	从映像生成器模板中删除映像生成器输出分发服务器。	核心	GA
az image builder output versioning	管理映像生成器模板输出版本器。	核心	GA
az image builder output versioning remove	删除指定输出上的所有版本控制选项。	核心	GA
az image builder output versioning set	设置映像生成器模板的映像生成器输出版本器。	核心	GA
az image builder output versioning show	显示指定输出上的版本控制选项。	核心	GA

az image builder output add

将映像生成器输出分发服务器添加到映像生成器模板。

必须与 --defer 一起使用。 输出分发服务器可以是托管映像、库映像或 VHD Blob。

az image builder output add [--artifact-tags]
                            [--defer]
                            [--gallery-image-definition]
                            [--gallery-name]
                            [--gallery-replication-regions]
                            [--ids]
                            [--is-vhd]
                            [--managed-image]
                            [--managed-image-location]
                            [--name]
                            [--output-name]
                            [--resource-group]
                            [--subscription]
                            [--versioning {Latest, Source}]
                            [--vhd-uri]

示例

将托管映像分发服务器添加到 cli 对象缓存中的映像模板。 指定运行输出名称。

az image builder output add -n mytemplate -g my-group \
    --managed-image my_desired_image_name --output-name managed_image_run_01 --defer

将共享映像库分发服务器添加到 cli 对象缓存中的映像模板。 指定其副本 (replica)区域。

az image builder output add -n mytemplate -g my-group --gallery-name my_shared_gallery \
    --gallery-replication-regions westus brazilsouth \
    --gallery-image-definition linux_image_def --defer

将 VHD 分发服务器添加到 cli 对象缓存中的映像模板。

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd  --defer

在 cli 对象缓存中添加 VHD 分发服务器，并将存储 URI 指定到映像模板。

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd --vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file --defer

可选参数

--artifact-tags

分发服务器创建输出项目后将应用于输出项目的标记。 空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--defer

暂时将对象存储在本地缓存中，而不是发送到 Azure。 使用 az cache 命令查看/清除。

--gallery-image-definition

用于创建自定义映像版本的现有 SIG 映像定义的名称或 ID。

--gallery-name

如果提供了映像定义名称而不是 ID，则共享映像库名称。

--gallery-replication-regions

要副本 (replica)映像版本进入的区域的空间分隔列表。 默认为资源组的位置。

--ids

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

--is-vhd

输出是 VHD 分发服务器。

--managed-image

要创建的自定义托管映像的名称或 ID。

--managed-image-location

将创建自定义映像的位置。 默认为资源组的位置。

--name -n

映像模板的名称。

--output-name

映像生成器运行输出的名称。 默认为托管映像或 sig 映像定义的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

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

--versioning

介绍如何为分发生成新的 x.y.z 版本号。

接受的值: Latest, Source

--vhd-uri

分布式 VHD blob 的可选Azure 存储 URI。 省略时将使用默认值（空字符串），在这种情况下，VHD 将发布到暂存资源组中的存储帐户。

全局参数

--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 image builder output clear

从映像生成器模板中删除所有映像生成器输出分发服务器。

必须与 --defer 一起使用。

az image builder output clear [--defer]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

可选参数

--defer

暂时将对象存储在本地缓存中，而不是发送到 Azure。 使用 az cache 命令查看/清除。

--ids

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

--name -n

映像模板的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--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 image builder output remove

从映像生成器模板中删除映像生成器输出分发服务器。

必须与 --defer 一起使用。

az image builder output remove --output-name
                               [--defer]
                               [--ids]
                               [--name]
                               [--resource-group]
                               [--subscription]

必需参数

--output-name

映像生成器运行输出的名称。

可选参数

--defer

暂时将对象存储在本地缓存中，而不是发送到 Azure。 使用 az cache 命令查看/清除。

--ids

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

--name -n

映像模板的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--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 获取完整的调试日志。