az image

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

명령

az image builder

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

az image builder cancel

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

az image builder create

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

az image builder customizer

이미지 작성기 템플릿 사용자 지정자를 관리합니다.

az image builder customizer add

이미지 작성기 템플릿에 이미지 작성기 사용자 지정자 추가

az image builder customizer clear

이미지 작성기 템플릿에서 모든 이미지 작성기 사용자 지정자를 제거합니다.

az image builder customizer remove

이미지 작성기 템플릿에서 이미지 작성기 사용자 지정자 제거

az image builder delete

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

az image builder list

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

az image builder output

이미지 작성기 템플릿 출력 배포자를 관리 합니다.

az image builder output add

이미지 작성기 템플릿에 이미지 작성기 출력 배포자를 추가 합니다.

az image builder output clear

이미지 작성기 템플릿에서 모든 이미지 작성기 출력 배포자를 제거 합니다.

az image builder output remove

이미지 작성기 템플릿에서 이미지 작성기 출력 배포자를 제거 합니다.

az image builder run

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

az image builder show

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

az image builder show-runs

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

az image builder update

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

az image builder wait

템플릿의 조건이 충족 될 때까지 대기 상태에 CLI를 추가 합니다.

az image copy

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

az image create

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

az image delete

이미지를 삭제합니다.

az image list

사용자 지정 VM 이미지를 나열합니다.

az image show

이미지를 가져옵니다.

az image update

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

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

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

--export-as-snapshot

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

--parallel-degree

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

기본값: -1
--source-type

이미지 또는 vm.

허용되는 값: image, vm
기본값: image
--tags

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

--target-name

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

--target-subscription

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

--temporary-resource-group-name --temporary_resource_group_name

임시 스토리지 계정을 만들 리소스 그룹 이름입니다. --temporary_resource_group_name 0.2.7에서 더 이상 사용되지 않습니다.

기본값: image-copy-rg
--timeout

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

기본값: 3600

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 {Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--subscription]
                [--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

이미지의 데이터 디스크에 대한 캐싱 유형을 Storage.

허용되는 값: None, ReadOnly, ReadWrite
--data-disk-sources

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

--edge-zone

에지 영역의 이름입니다.

--hyper-v-generation

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

허용되는 값: V1, V2
기본값: V1
--location -l

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

--os-disk-caching

이미지의 OS 디스크에 대한 캐싱 유형을 Storage.

허용되는 값: None, ReadOnly, ReadWrite
--os-type
허용되는 값: Linux, Windows
--storage-sku

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

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

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

--tags

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

--zone-resilient

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

허용되는 값: false, true

az image delete

이미지를 삭제합니다.

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

선택적 매개 변수

--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 있습니다.

az image list

사용자 지정 VM 이미지를 나열합니다.

az image list [--query-examples]
              [--resource-group]
              [--subscription]

선택적 매개 변수

--query-examples

JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 확인할 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resource-group -g

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

--subscription

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

az image show

이미지를 가져옵니다.

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

선택적 매개 변수

--expand

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

--ids

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

--name -n

이미지의 이름입니다.

--query-examples

JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 확인할 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resource-group -g

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

--subscription

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

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 또는 JSON string>.

--force-string

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

--ids

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

--name -n

이미지의 이름입니다.

--remove

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

--resource-group -g

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

--set

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

--subscription

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

--tags

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