az image builder 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 builder output add

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

az image builder output clear

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

az image builder output remove

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

az image builder output add

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

Must be used with --defer. The output distributor can be a managed image, a gallery image, or as a 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]

Examples

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

az image builder 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 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

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

az image builder 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: key[=value] [key[=value] ...]. 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). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

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

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

Must be used with --defer.

az image builder 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). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

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

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

Must be used with --defer.

az image builder 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). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--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.