az image

참고 항목

이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.

사용자 지정 가상 머신 이미지를 관리합니다.

명령

Name	Description	형식	상태
az image builder	이미지 작성기 템플릿을 관리하고 빌드합니다.	핵심	GA
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 copy	관리되는 이미지(또는 vm)를 다른 지역에 복사합니다. 원본 디스크를 사용할 수 있어야 합니다.	내선 번호	GA
az image create	관리 디스크 또는 스냅샷 사용자 지정 Virtual Machine 이미지를 만듭니다.	핵심	GA
az image delete	이미지를 삭제합니다.	핵심	GA
az image list	리소스 그룹 아래에 이미지 목록을 나열합니다.	핵심	GA
az image show	이미지를 가져옵니다.	핵심	GA
az image update	사용자 지정 VM 이미지를 업데이트합니다.	핵심	GA
az image wait	조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.	핵심	GA

az image copy

관리되는 이미지(또는 vm)를 다른 지역에 복사합니다. 원본 디스크를 사용할 수 있어야 합니다.

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"

필수 매개 변수

--source-object-name

이미지 또는 vm 리소스의 이름입니다.

--source-resource-group

원본 리소스의 리소스 그룹의 이름입니다.

--target-location

이미지를 만들 공간으로 구분된 위치 목록(예: westeurope 등)입니다.

--target-resource-group

이미지를 만들 리소스 그룹의 이름입니다.

선택적 매개 변수

--cleanup

완료 시 임시 리소스를 삭제하려면 이 스위치를 포함합니다.

Default value: False

--export-as-snapshot

복사본을 이미지 대신 스냅샷 내보내려면 이 스위치를 포함합니다.

Default value: False

--parallel-degree

병렬 복사 작업의 수입니다.

Default value: -1

--source-type

이미지 또는 vm.

허용되는 값: image, vm

Default value: image

--tags

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

--target-name

만들 최종 이미지의 이름입니다.

--target-subscription

최종 이미지를 만들어야 하는 구독의 이름 또는 ID입니다.

--temporary-resource-group-name

임시 스토리지 계정을 만들 리소스 그룹 이름입니다.

Default value: image-copy-rg

--timeout

복사 작업이 완료된 시간(초)입니다. 512GB 이상과 같은 큰 이미지(디스크)를 복사하려는 경우 이 시간을 늘입니다.

Default value: 3600

전역 매개 변수

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

관리 디스크 또는 스냅샷 사용자 지정 Virtual Machine 이미지를 만듭니다.

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

필수 매개 변수

--name -n

새 이미지 이름입니다.

--resource-group -g

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

--source

가상 머신 ID 또는 이름, OS 디스크 Blob URI, 관리되는 OS 디스크 ID 또는 이름 또는 OS 스냅샷 ID 또는 이름을 포함하여 동일한 지역의 OS 디스크 원본입니다.

선택적 매개 변수

--data-disk-caching

이미지의 데이터 디스크에 대한 스토리지 캐싱 유형입니다.

허용되는 값: None, ReadOnly, ReadWrite

--data-disk-sources

관리되지 않는 Blob URI, 관리 디스크 ID 또는 이름 또는 스냅샷 ID 또는 이름을 포함하여 공간으로 구분된 데이터 디스크 원본 목록입니다.

--edge-zone

에지 영역의 이름입니다.

--hyper-v-generation

이미지에서 만든 Virtual Machine의 하이퍼바이저 생성입니다.

허용되는 값: V1, V2

Default value: V1

--location -l

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

--os-disk-caching

이미지의 OS 디스크에 대한 스토리지 캐싱 유형입니다.

허용되는 값: None, ReadOnly, ReadWrite

--os-type

허용되는 값: Linux, Windows

--storage-sku

VM 이미지를 만들 스토리지 계정의 SKU입니다. 원본 VM이 지정된 경우 사용되지 않습니다.

허용되는 값: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

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

--zone-resilient

이미지가 영역 복원력인지 여부를 지정합니다. 기본값은 false입니다. 영역 복원력 이미지는 영역 중복 스토리지를 제공하는 지역에서만 만들 수 있습니다.

허용되는 값: false, true

전역 매개 변수

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

이미지를 삭제합니다.

az image delete [--ids]
                [--image-name]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--resource-group]
                [--subscription]

선택적 매개 변수

--ids

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

--image-name --name -n

이미지의 이름입니다.

--no-wait

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

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes

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

리소스 그룹 아래에 이미지 목록을 나열합니다.

az image list [--max-items]
              [--next-token]
              [--resource-group]

선택적 매개 변수

--max-items

명령의 출력에서 반환할 총 항목 수입니다. 사용 가능한 총 항목 수가 지정된 값보다 많으면 명령의 출력에 토큰이 제공됩니다. 페이지 매김을 다시 시작하려면 후속 명령의 인수에 --next-token 토큰 값을 제공합니다.

--next-token

페이지 매김을 시작할 위치를 지정하는 토큰입니다. 이는 이전에 잘린 응답의 토큰 값입니다.

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

이미지를 가져옵니다.

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

선택적 매개 변수

--expand

작업에 적용할 확장 식입니다.

--ids

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

--image-name --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 update

사용자 지정 VM 이미지를 업데이트합니다.

az image update [--add]
                [--force-string]
                [--ids]
                [--name]
                [--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

선택적 매개 변수

--add

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

Default value: []

--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기본 구독을 구성할 수 있습니다.

--tags

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

전역 매개 변수

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

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

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

선택적 매개 변수

--created

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

Default value: False

--custom

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

--deleted

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

Default value: False

--exists

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

Default value: False

--expand

작업에 적용할 확장 식입니다.

--ids

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

--image-name --name -n

이미지의 이름입니다.

--interval

폴링 간격(초)입니다.

Default value: 30

--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를 사용합니다.