Share via

az image builder output versioning

  • Reference

Manage image builder template output versioner.

Describe how to generate new x.y.z version number for distribution.

Commands

Name Description Type Status
az image builder output versioning remove

Remove all versioning options on specified outputs.

 Core GA
az image builder output versioning set

Set the image builder output versioner of an image builder template.

 Core GA
az image builder output versioning show

Show versioning options on specified outputs.

 Core GA

az image builder output versioning remove

Remove all versioning options on specified outputs.

Must be used with --defer.

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

Examples

Remove the image builder output versioner of specified outputs.

az image builder output versioning remove -n MyTemplate -g MyResourceGroup --output-name MyVhdImage --defer

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.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

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

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az image builder output versioning set

Set the image builder output versioner of an image builder template.

Must be used with --defer.

az image builder output versioning set --output-name
                                       --scheme {Latest, Source}
                                       [--defer]
                                       [--ids]
                                       [--major]
                                       [--name]
                                       [--resource-group]
                                       [--subscription]

Examples

Set the image builder output versioner generating version number that will be latest based on existing version numbers.

az image builder output versioning set -n MyTemplate -g MyResourceGroup --output-name MyVhdImage --scheme Latest --defer

Set the image builder output versioner generating version number that will be latest based on specified major version.

az image builder output versioning set -n MyTemplate -g MyResourceGroup --output-name MyVhdImage --scheme Latest --major 1 --defer

Set the image builder output versioner generating version number based on version number of source image.

az image builder output versioning set -n MyTemplate -g MyResourceGroup --output-name MyVhdImage --scheme Source --defer

Required Parameters

--output-name

Name of the image builder run output.

--scheme

Version numbering scheme to be used.

Accepted values: Latest, Source

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.

--major

Major version for the generated version number. Determine what is "latest" based on versions with this value as the major version. -1 is equivalent to leaving it unset.

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

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

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

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az image builder output versioning show

Show versioning options on specified outputs.

Must be used with --defer.

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

Examples

Show the image builder output versioner of specified outputs.

az image builder output versioning show -n MyTemplate -g MyResourceGroup --output-name MyVhdImage --defer

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.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

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

--verbose

Increase logging verbosity. Use --debug for full debug logs.