az image template output

Manage image builder template output distributors.

A customized image can be distributed as a managed image, a shared image in a shared image gallery (SIG), or as a VHD blob.

Commands

az image template output add Add an image builder output distributor to an image builder template.
az image template output clear Remove all image builder output distributors from an image builder template.
az image template output remove Remove an image builder output distributor from an image builder template.

az image template output add

Add an image builder output distributor to an image builder template.

az image template 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]

Examples

Add a managed image distributor to an image template in the cli object cache. Specify a run output name.

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

Add a shared image gallery distributor to an image template in the cli object cache. Specify its replication regions.

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

Add a VHD distributor to an image template in the cli object cache.

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

Optional Parameters

--artifact-tags

Tags that will be applied to the output artifact once it has been created by the distributor. space-separated tags in 'key[=value]' format. Use "" to clear existing tags.

--defer

Temporarily store the object in the local cache instead of sending to Azure. Use az cache commands to view/clear.

--gallery-image-definition

Name or ID of the existing SIG image definition to create the customized image version with.

--gallery-name

Shared image gallery name, if image definition name and not ID was provided.

--gallery-replication-regions

Space-separated list of regions to replicate the image version into. Defaults to resource group's location.

--ids

One or more resource IDs (space-delimited). If provided, no other 'Resource Id' arguments should be specified.

--is-vhd

The output is a VHD distributor.

--managed-image

Name or ID of the customized managed image to be created.

--managed-image-location

Location where the customized image will be created. Defaults to resource group's location.

--name -n

The name of the image template.

--output-name

Name of the image builder run output. Defaults to the name of the managed image or sig image definition.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

az image template output clear

Remove all image builder output distributors from an image builder template.

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

Optional Parameters

--defer

Temporarily store the object in the local cache instead of sending to Azure. Use az cache commands to view/clear.

--ids

One or more resource IDs (space-delimited). If provided, no other 'Resource Id' arguments should be specified.

--name -n

The name of the image template.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

az image template output remove

Remove an image builder output distributor from an image builder template.

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

Required Parameters

--output-name

Name of the image builder run output.

Optional Parameters

--defer

Temporarily store the object in the local cache instead of sending to Azure. Use az cache commands to view/clear.

--ids

One or more resource IDs (space-delimited). If provided, no other 'Resource Id' arguments should be specified.

--name -n

The name of the image template.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.