az image builder

이미지 작성기 템플릿을 관리하고 빌드합니다.

명령

Name	Description	형식	상태
az image builder cancel	이미지 템플릿을 기반으로 장기 실행 이미지 빌드를 취소합니다.	핵심	GA
az image builder create	이미지 작성기 템플릿을 만듭니다.	핵심	GA
az image builder customizer	이미지 작성기 템플릿 사용자 지정자를 관리합니다.	핵심	GA
az image builder customizer add	이미지 작성기 템플릿에 이미지 작성기 사용자 지정자를 추가합니다.	핵심	GA
az image builder customizer clear	이미지 작성기 템플릿에서 모든 이미지 작성기 사용자 지정자를 제거합니다.	핵심	GA
az image builder customizer remove	이미지 작성기 템플릿에서 이미지 작성기 사용자 지정자를 제거합니다.	핵심	GA
az image builder delete	이미지 작성기 템플릿을 삭제합니다.	핵심	GA
az image builder error-handler	이미지 작성기 템플릿 오류 처리기를 관리합니다.	핵심	GA
az image builder error-handler add	기존 이미지 작성기 템플릿에 오류 처리기를 추가합니다.	핵심	GA
az image builder error-handler remove	기존 이미지 작성기 템플릿에서 오류 처리기를 제거합니다.	핵심	GA
az image builder error-handler show	기존 이미지 작성기 템플릿의 오류 처리기를 표시합니다.	핵심	GA
az image builder identity	이미지 작성기 템플릿의 ID를 관리합니다.	핵심	GA
az image builder identity assign	기존 이미지 작성기 템플릿에 관리 ID를 추가합니다. 현재는 하나의 사용자 ID만 지원됩니다.	핵심	GA
az image builder identity remove	기존 이미지 작성기 템플릿에서 관리 ID를 제거합니다.	핵심	GA
az image builder identity show	이미지 작성기 템플릿의 관리 ID를 표시합니다.	핵심	GA
az image builder list	이미지 작성기 템플릿을 나열합니다.	핵심	GA
az image builder optimizer	이미지 작성기 템플릿 최적화 프로그램 관리	핵심	GA
az image builder optimizer add	기존 이미지 작성기 템플릿에 최적화 프로그램 추가	핵심	GA
az image builder optimizer remove	기존 이미지 작성기 템플릿에서 최적화 프로그램 제거	핵심	GA
az image builder optimizer show	기존 이미지 작성기 템플릿의 최적화 프로그램 표시	핵심	GA
az image builder optimizer update	기존 이미지 작성기 템플릿에서 최적화 프로그램 업데이트	핵심	GA
az image builder output	이미지 작성기 템플릿 출력 배포자를 관리합니다.	핵심	GA
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 run	이미지 작성기 템플릿을 빌드합니다.	핵심	GA
az image builder show	이미지 작성기 템플릿을 표시합니다.	핵심	GA
az image builder show-runs	이미지 작성기 템플릿의 실행 출력을 표시합니다.	핵심	GA
az image builder trigger	이미지 작성기 템플릿 트리거를 관리합니다.	핵심	GA
az image builder trigger create	지정된 가상 머신 이미지 템플릿에 대한 트리거를 만듭니다.	핵심	GA
az image builder trigger delete	지정된 가상 머신 이미지 템플릿에 대한 트리거를 삭제합니다.	핵심	GA
az image builder trigger list	지정된 이미지 템플릿 리소스에 대한 모든 트리거를 나열합니다.	핵심	GA
az image builder trigger show	지정된 이미지 템플릿 리소스에 대해 지정된 트리거를 가져옵니다.	핵심	GA
az image builder trigger wait	조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.	핵심	GA
az image builder update	이미지 작성기 템플릿을 업데이트합니다.	핵심	GA
az image builder validator	이미지 작성기 템플릿 유효성 검사를 관리합니다.	핵심	GA
az image builder validator add	기존 이미지 작성기 템플릿에 유효성 검사를 추가합니다.	핵심	GA
az image builder validator remove	기존 이미지 작성기 템플릿에서 유효성 검사를 제거합니다.	핵심	GA
az image builder validator show	기존 이미지 작성기 템플릿의 유효성 검사를 표시합니다.	핵심	GA
az image builder wait	템플릿 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.	핵심	GA

az image builder cancel

이미지 템플릿을 기반으로 장기 실행 이미지 빌드를 취소합니다.

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

예제

이미지 빌드를 취소합니다.

az image builder cancel -n mytemplate -g my-group

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 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

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder create

이미지 작성기 템플릿을 만듭니다.

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--build-vm-identities]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--proxy-vm-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--staging-resource-group]
                        [--subnet]
                        [--tags]
                        [--validator]
                        [--vm-size]
                        [--vnet]

예제

Ubuntu2204 이미지에서 이미지 작성기 템플릿을 만듭니다. 관리되는 이미지 및 공유 이미지 갤러리 이미지 버전으로 배포합니다. 준비 리소스 그룹 ID를 이미지를 빌드하는 데 사용할 이미지 템플릿으로 지정합니다.

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest"

az image builder create --image-source $imagesource -n myTemplate -g myGroup \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myIdentity --staging-resource-group myStagingResourceGroup

이미지 템플릿 파일을 사용하여 이미지 작성기 템플릿을 만듭니다.

az image builder create -g my-group -n myTemplate --image-template filename

[고급] --defer를 통해 CLI의 개체 캐시를 사용하여 여러 사용자 지정자 및 배포자가 있는 이미지 템플릿을 만듭니다. 사용자 지정자 및 출력 이름, powershell 종료 코드, 인라인 스크립트, Windows 다시 시작, 파일 사용자 지정자, 아티팩트 태그 및 vhd 출력 배포자와 같은 기능을 지원합니다.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n myTemplate \
    -g myGroup --scripts $script --identity myIdentity --defer

# add customizers
az image builder customizer add -n myTemplate -g myGroup  \
    --customizer-name myPwshScript --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFileCustomizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n myTemplate -g myGroup --is-vhd \
    --output-name myWinImageVhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n myTemplate -g myGroup \
    --output-name myWinImageManaged --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n myTemplate -g myGroup

필수 매개 변수

--name -n

이미지 템플릿의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--build-timeout

이미지 템플릿을 빌드하는 동안 대기할 최대 기간(분)입니다. 기본값은 60입니다.

--build-vm-identities

빌드 가상 머신을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다.

--checksum

Red Hat ISO 이미지의 SHA256 검사소입니다.

--defer

Azure로 보내는 대신 로컬 캐시에 개체를 일시적으로 저장합니다. 명령을 사용하여 az cache 보거나 지웁니다.

--identity

이미지 템플릿의 사용자 할당 ID(이름 또는 ID, 공백으로 구분된)의 목록입니다.

--image-source -i

사용자 지정할 기본 이미지입니다. 유효한 플랫폼 이미지 URN, 플랫폼 이미지 별칭, Red Hat ISO 이미지 URI, 관리되는 이미지 이름/ID 또는 공유 이미지 버전 ID여야 합니다.

다음의 값: az vm image list, az vm image show

--image-template

이미지 템플릿 파일의 로컬 경로 또는 URL입니다. --image-template을 사용하는 경우 -g 및 -n을 제외한 다른 모든 매개 변수는 무시됩니다. 참조: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--managed-image-destinations

관리되는 이미지 출력 배포자 정보입니다. 키-값 쌍의 공백으로 구분된 목록입니다. 예: "image_1=westus2 image_2=westus"입니다. 각 키는 만들 관리되는 이미지의 이름 또는 리소스 ID입니다. 각 값은 이미지의 위치입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False

--os-disk-size

OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다.

--proxy-vm-size

이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4).

--scripts

이미지를 사용자 지정할 셸 또는 PowerShell 스크립트의 공백으로 구분된 목록입니다. 각 스크립트는 공개적으로 액세스할 수 있는 URL이어야 합니다. 파일 확장명('.sh' 또는 '.ps1') 또는 원본 형식에서 스크립트 형식을 유추합니다. 더 많은 사용자 지정자 옵션 및 유연성은 'az image template customizer add'를 참조하세요.

--shared-image-destinations

공유 이미지 갤러리(sig) 출력 배포자 정보입니다. 키-값 쌍의 공백으로 구분된 목록입니다. 예: "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth." 각 키는 "/"로 구분된 sig 이미지 정의 ID 또는 sig 갤러리 이름 및 sig 이미지 정의입니다. 각 값은 쉼표로 구분된 복제본(replica) 위치 목록입니다.

--staging-resource-group

이미지를 빌드하는 데 사용할 이미지 템플릿과 동일한 구독의 준비 리소스 그룹 ID입니다.

--subnet

빌드 가상 머신을 배포할 서브넷의 이름 또는 ID입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--validator

이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.

--vm-size

이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값(Standard_D1_v2)을 사용하도록 빈 문자열을 생략하거나 지정합니다.

--vnet

빌드 가상 머신을 배포할 VNET의 이름입니다. 서브넷이 이름인 경우에만 지정해야 합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder delete

이미지 작성기 템플릿을 삭제합니다.

az image builder delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

예제

이미지 작성기 템플릿을 삭제합니다. (자동 생성됨)

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 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

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder list

이미지 작성기 템플릿을 나열합니다.

az image builder list [--resource-group]

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder run

이미지 작성기 템플릿을 빌드합니다.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

예제

템플릿 빌드 실행을 시작한 다음 완료되기를 기다립니다.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

이미지 템플릿의 이름입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False

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

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder show

이미지 작성기 템플릿을 표시합니다.

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

예제

이미지 작성기 템플릿 표시(자동 생성됨)

az image builder show --name mytemplate  --resource-group my-group

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 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

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder show-runs

이미지 작성기 템플릿의 실행 출력을 표시합니다.

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

예제

템플릿 빌드 실행을 실행한 다음 실행 출력을 봅니다.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show-runs -n mytemplate -g my-group

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

이미지 템플릿의 이름입니다.

--output-name

이미지 작성기 실행 출력의 이름입니다.

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

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder update

이미지 작성기 템플릿을 업데이트합니다.

이미지 작성기 템플릿 업데이트는 현재 지원되지 않습니다. 이 명령은 --defer와 함께 사용하여 CLI 캐시 내에서 이미지 템플릿 개체를 업데이트할 수 있습니다. --defer를 사용하지 않으면 캐시에서 지정된 이미지 템플릿을 검색하고 Azure에 요청하여 이미지 템플릿을 만듭니다.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

예제

cli 캐시의 템플릿 개체에서 템플릿 리소스를 만듭니다. 자세한 내용은 "az image builder create / output add / customizer add --help" 및 "az cache -h"를 참조하세요.

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>

Default value: []

--defer

Azure로 보내는 대신 로컬 캐시에 개체를 일시적으로 저장합니다. 명령을 사용하여 az cache 보거나 지웁니다.

--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

Default value: False

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

이미지 템플릿의 이름입니다.

--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>

Default value: []

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder wait

템플릿 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az image builder wait [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--ids]
                      [--interval]
                      [--name]
                      [--resource-group]
                      [--subscription]
                      [--timeout]
                      [--updated]

예제

템플릿 빌드 실행을 시작한 다음 완료되기를 기다립니다.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView. 상태es[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

Default value: False

--exists

리소스가 존재할 때까지 기다립니다.

Default value: False

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--interval

폴링 간격(초)입니다.

Default value: 30

--name -n

이미지 템플릿의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--timeout

최대 대기 시간(초)입니다.

Default value: 3600

--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.