az image

命令

名称	说明	类型	Status
az image builder	管理和生成映像生成器模板。	Core	GA
az image builder cancel	根据映像模板取消长时间运行的映像生成。	Core	GA
az image builder create	创建映像生成器模板。	Core	GA
az image builder customizer	管理映像生成器模板定制器。	Core	GA
az image builder customizer add	将映像生成器定制器添加到映像生成器模板。	Core	GA
az image builder customizer clear	从映像生成器模板中删除所有映像生成器自定义工具。	Core	GA
az image builder customizer remove	从映像生成器模板中删除映像生成器定制器。	Core	GA
az image builder delete	删除映像生成器模板。	Core	GA
az image builder error-handler	管理映像生成器模板错误处理程序。	Core	GA
az image builder error-handler add	将错误处理程序添加到现有映像生成器模板。	Core	GA
az image builder error-handler remove	从现有映像生成器模板中删除错误处理程序。	Core	GA
az image builder error-handler show	显示现有映像生成器模板的错误处理程序。	Core	GA
az image builder identity	管理映像生成器模板的标识。	Core	GA
az image builder identity assign	将托管标识添加到现有映像生成器模板。 目前，仅支持一个用户标识。	Core	GA
az image builder identity remove	从现有映像生成器模板中删除托管标识。	Core	GA
az image builder identity show	显示映像生成器模板的托管标识。	Core	GA
az image builder list	列出映像生成器模板。	Core	GA
az image builder optimizer	管理映像生成器模板优化器。	Core	GA
az image builder optimizer add	将优化器添加到现有映像生成器模板。	Core	GA
az image builder optimizer remove	从现有映像生成器模板中删除优化器。	Core	GA
az image builder optimizer show	显示现有映像生成器模板的优化器。	Core	GA
az image builder optimizer update	从现有映像生成器模板更新优化器。	Core	GA
az image builder output	管理映像生成器模板输出分发服务器。	Core	GA
az image builder output add	将映像生成器输出分发服务器添加到映像生成器模板。	Core	GA
az image builder output clear	从映像生成器模板中删除所有映像生成器输出分发服务器。	Core	GA
az image builder output remove	从映像生成器模板中删除映像生成器输出分发服务器。	Core	GA
az image builder output versioning	管理映像生成器模板输出版本器。	Core	GA
az image builder output versioning remove	删除指定输出上的所有版本控制选项。	Core	GA
az image builder output versioning set	设置映像生成器模板的映像生成器输出版本器。	Core	GA
az image builder output versioning show	显示指定输出上的版本控制选项。	Core	GA
az image builder run	生成映像生成器模板。	Core	GA
az image builder show	显示映像生成器模板。	Core	GA
az image builder show-runs	显示映像生成器模板的运行输出。	Core	GA
az image builder trigger	管理映像生成器模板触发器。	Core	GA
az image builder trigger create	为指定的虚拟机映像模板创建触发器。	Core	GA
az image builder trigger delete	删除指定虚拟机映像模板的触发器。	Core	GA
az image builder trigger list	列出指定图像模板资源的所有触发器。	Core	GA
az image builder trigger show	获取指定映像模板资源的指定触发器。	Core	GA
az image builder trigger wait	将 CLI 置于等待状态，直到满足条件。	Core	GA
az image builder update	更新映像生成器模板。	Core	GA
az image builder validator	管理映像生成器模板验证。	Core	GA
az image builder validator add	向现有映像生成器模板添加验证。	Core	GA
az image builder validator remove	从现有映像生成器模板中删除验证。	Core	GA
az image builder validator show	显示现有映像生成器模板的验证。	Core	GA
az image builder wait	将 CLI 置于等待状态，直到满足模板的条件。	Core	GA
az image copy	将托管映像（或 vm）复制到其他区域。 它要求源磁盘可用。	Extension	GA
az image create	从托管磁盘或快照创建自定义虚拟机映像。	Core	GA
az image delete	删除图像。	Core	GA
az image list	列出资源组下的图像列表。	Core	GA
az image show	获取图像。	Core	GA
az image update	更新自定义 VM 映像。	Core	GA
az image wait	将 CLI 置于等待状态，直到满足条件。	Core	GA

az image copy --source-object-name
              --source-resource-group
              --target-location
              --target-resource-group
              [--cleanup]
              [--export-as-snapshot]
              [--parallel-degree]
              [--source-type {image, vm}]
              [--tags]
              [--target-name]
              [--target-subscription]
              [--temporary-resource-group-name]
              [--timeout]

示例

将映像复制到多个区域，并在末尾进行清理。

az image copy --source-resource-group mySources-rg --source-object-name myImage \
    --target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup

使用已通用 VM 在其他区域中创建映像。

az image copy --source-resource-group mySources-rg --source-object-name myVm \
    --source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"

必需参数

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--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 image create --name
                --resource-group
                --source
                [--data-disk-caching {None, ReadOnly, ReadWrite}]
                [--data-disk-sources]
                [--edge-zone]
                [--hyper-v-generation {V1, V2}]
                [--location]
                [--os-disk-caching {None, ReadOnly, ReadWrite}]
                [--os-type {Linux, Windows}]
                [--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--tags]
                [--zone-resilient {false, true}]

示例

从现有磁盘创建映像。

az image create -g MyResourceGroup -n image1 --os-type Linux \
    --source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1

通过捕获同一资源组中的现有通用化虚拟机来创建映像。

az image create -g MyResourceGroup -n image1 --source MyVm1

必需参数

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--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 image delete [--ids]
                [--image-name --name]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--resource-group]
                [--subscription]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--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 image list [--max-items]
              [--next-token]
              [--resource-group]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--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 image show [--expand]
              [--ids]
              [--image-name --name]
              [--resource-group]
              [--subscription]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--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 image update [--add]
                [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                [--ids]
                [--image-name --name]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--remove]
                [--resource-group]
                [--set]
                [--subscription]
                [--tags]

示例

添加或更新标记。

az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2

删除所有标记。

az image update -n ImageName -g resourceGroup --tags

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

--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 image wait [--created]
              [--custom]
              [--deleted]
              [--exists]
              [--expand]
              [--ids]
              [--image-name --name]
              [--interval]
              [--resource-group]
              [--subscription]
              [--timeout]
              [--updated]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

全局参数

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