az sig image-version
참고 항목
이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.
VM을 사용하여 공유 갤러리 이미지 버전을 관리합니다.
명령
| Name | Description | 형식 | 상태 |
|---|---|---|---|
| az sig image-version create |
새 이미지 버전을 만듭니다. |
핵심 | GA |
| az sig image-version delete |
갤러리 이미지 버전을 삭제합니다. |
핵심 | GA |
| az sig image-version list |
갤러리 이미지 정의에 갤러리 이미지 버전을 나열합니다. |
핵심 | GA |
| az sig image-version list-community |
갤러리 커뮤니티에서 VM 이미지 버전을 나열합니다. |
핵심 | GA |
| az sig image-version list-community (image-gallery 확장) |
갤러리 커뮤니티(미리 보기)에서 VM 이미지 버전을 나열합니다. |
내선 번호 | 실험적 |
| az sig image-version list-shared |
구독 또는 테넌트에 직접 공유되는 갤러리의 VM 이미지 버전을 나열합니다. |
핵심 | GA |
| az sig image-version show |
갤러리 이미지 버전에 대한 정보를 검색합니다. |
핵심 | GA |
| az sig image-version show-community |
커뮤니티 갤러리 이미지 버전을 가져옵니다. |
핵심 | GA |
| az sig image-version show-community (image-gallery 확장) |
갤러리 커뮤니티(미리 보기)에서 이미지 버전을 가져옵니다. |
내선 번호 | 실험적 |
| az sig image-version show-shared |
구독 또는 테넌트에 직접 공유되는 갤러리에서 이미지 버전을 가져옵니다. |
핵심 | GA |
| az sig image-version undelete |
일시 삭제된 이미지 버전을 복원합니다. |
핵심 | 프리뷰 |
| az sig image-version update |
공유 이미지 버전을 업데이트합니다. |
핵심 | GA |
| az sig image-version wait |
이미지 버전 관련 작업을 기다립니다. |
핵심 | GA |
az sig image-version create
새 이미지 버전을 만듭니다.
이 작업은 복제본(replica)te 지역 번호에 따라 시간이 오래 걸릴 수 있습니다. "--no-wait"를 사용하는 것이 좋습니다.
az sig image-version create --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--data-snapshot-luns]
[--data-snapshots]
[--data-vhds-luns]
[--data-vhds-sa]
[--data-vhds-uris]
[--end-of-life-date]
[--exclude-from-latest {false, true}]
[--image-version]
[--location]
[--managed-image]
[--no-wait]
[--os-snapshot]
[--os-vhd-storage-account]
[--os-vhd-uri]
[--replica-count]
[--replication-mode {Full, Shallow}]
[--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
[--tags]
[--target-edge-zone-encryption]
[--target-edge-zones]
[--target-region-cvm-encryption]
[--target-region-encryption]
[--target-regions]
[--virtual-machine]예제
가상 머신에서 새 이미지 버전 추가
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM관리되는 이미지에서 새 이미지 버전 추가
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--managed-image /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/images/MyManagedImage다른 이미지 버전에서 새 이미지 버전 추가
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--image-version /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/galleries/MyGallery/images/MyImageDefinition/versions/1.0.0관리 디스크에서 새 이미지 버전 추가
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk관리 디스크에서 새 이미지 버전을 추가하고 데이터 디스크를 추가합니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk \
--data-snapshot-luns 0OS 디스크의 스냅샷 새 이미지 버전을 추가합니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshotOS 디스크의 스냅샷 새 이미지 버전을 추가하고 데이터 디스크로 스냅샷 추가
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0OS 디스크의 VHD에서 새 이미지 버전을 추가합니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_fileOS 디스크의 VHD에서 새 이미지 버전을 추가하고 추가 VHD를 데이터 디스크로 추가
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-sa /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/myotherstorageaccount \
--data-vhds-uris https://myotherstorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-luns 0스냅샷, 관리 디스크 및 VHD를 결합하여 새 이미지 버전을 만들 수 있습니다. VHD를 OS 디스크로, 관리 디스크로, 스냅샷 데이터 디스크로 사용하여 새 이미지 버전을 추가합니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0 1새 이미지 버전을 추가하고 추가 지역에 복사합니다. 이미지 버전의 원본에 대한 홈 위치는 대상 지역 목록에 포함되어야 합니다. 각 추가 지역에 대해 다른 복제본(replica) 개수 및 스토리지 계정 유형을 지정할 수 있습니다. 그렇지 않으면 지역은 전역에서 상속됩니다. 기본 복제본(replica) 개수는 1이고 기본 스토리지 계정 유형은 표준 LRS입니다. 이 예제에서 eastus2는 표준 ZRS 스토리지에 하나의 복제본(replica) 저장하고, ukwest는 표준 ZRS 스토리지에 3개의 복제본(replica) 저장하고, southindia는 표준 LRS 스토리지에 하나의 복제본(replica) 저장하고, brazilsouth는 표준 LRS 스토리지에 2개의 복제본(replica) 저장합니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-regions eastus2 ukwest=3 southindia=standard_lrs \
brazilsouth=2=standard_lrs디스크 암호화 집합을 사용하여 암호화를 사용하여 새 이미지 버전을 추가합니다. 암호화는 이미지 버전의 일부인 각 디스크에 적용됩니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-regions westus=2=standard eastus \
--target-region-encryption WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2 \
EastUSDiskEncryptionSet1,0,EastUSDiskEncryptionSet2새 이미지 버전을 추가하고 확장된 위치에 복사합니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1 \
brazilsouth=2=standard_lrs새 이미지 버전을 추가하고 디스크 암호화 집합을 사용하여 암호화를 사용하여 확장된 위치에 복사합니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-edge-zones westus=microsoftlosangeles1 \
--target-edge-zone-encryption microsoftlosangeles1,WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2새 이미지 버전을 추가하고 기다리지 마세요. 나중에 갤러리 이미지 버전에서 vm을 만들 준비가 되면 "az sig image-version wait" 명령을 호출할 수 있습니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--no-wait새 이미지 버전을 추가하지만 이미지 정의의 최신 버전으로 고려에서 제거합니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--exclude-from-latest true새 이미지 버전을 추가하고 수명 종료 날짜를 설정합니다. 이미지 버전은 수명이 종료된 후에도 가상 머신을 만드는 데 계속 사용할 수 있습니다.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--end-of-life-date 2024-08-02T00:00:00+00:00필수 매개 변수
갤러리 이미지 정의입니다.
의미 체계 버전 패턴의 갤러리 이미지 버전입니다. 허용되는 문자는 숫자와 마침표입니다. 숫자는 32비트 정수 범위 내에 있어야 합니다(예: .). <MajorVersion>.<MinorVersion>.<Patch>
갤러리 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
복제본(replica)ted 지역에서 이 갤러리 이미지 버전을 제거할 수 있는지 여부를 나타냅니다.
데이터 디스크 스냅샷 논리적 단위 번호(공백으로 구분)입니다.
데이터 디스크 스냅샷 이름 또는 ID(공백으로 구분)입니다.
데이터 디스크의 원본 VHD URI의 논리적 단위 번호(공백으로 구분)입니다.
데이터 디스크의 원본 VHD URI에 대한 스토리지 계정의 이름 또는 ID(공백으로 구분)입니다.
데이터 디스크의 원본 VHD URI(공백으로 구분)입니다.
수명 종료 날짜(예: '2020-12-31')입니다.
플래그는 true로 설정된 경우 생략된 버전으로 VM을 배포하는 사용자가 이 버전을 사용하지 않음을 의미합니다.
갤러리 이미지 버전 원본의 리소스 ID입니다.
위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
이미지 이름(동일한 리소스 그룹에 있는 경우) 또는 리소스 ID입니다.
장기 실행 작업이 완료되기를 기다리지 마세요.
OS 디스크 스냅샷 이름 또는 ID입니다.
OS 디스크의 원본 VHD URI 스토리지 계정 이름 또는 ID입니다.
OS 디스크의 원본 VHD URI입니다.
지역별로 만들 기본 복제본(replica) 수입니다. 지역 복제본(replica) 횟수를 설정하려면 --target-regions를 사용합니다.
복제본(replica) 사용할 모드를 지정하는 선택적 매개 변수입니다. 이 속성은 업데이트할 수 없습니다.
지역별로 사용할 기본 스토리지 계정 유형입니다. 지역 스토리지 계정 유형을 설정하려면 --target-regions를 사용합니다.
공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.
각 지역에 대한 갤러리 아티팩트에서 OS 및 데이터 디스크를 암호화하기 위한 고객 관리 키의 공간 구분 목록입니다. 각 에지 영역의 형식: ,<os_des>,< lun1_des>,< lun2_des>.
영역, 에지 영역, 복제본(replica) 개수 및 스토리지 유형의 공간으로 구분된 목록입니다. =[=][=]를 사용하여 필요에 따라 각 지역에 대한 복제본(replica) 개수 및/또는 스토리지 계정 유형을 설정합니다. 복제본(replica) 개수를 지정하지 않으면 기본 복제본(replica) 수가 사용됩니다. 스토리지 계정 유형을 지정하지 않으면 기본 스토리지 계정 유형이 사용됩니다. "--target-edge-zones None"을 지정하면 대상 확장 위치가 지워집니다.
각 지역에 대한 갤러리 아티팩트에서 OS 디스크를 암호화하는 기밀 VM에 대한 고객 관리형 키의 공간 구분 목록입니다. 각 지역에 대한 형식: <os_cvm_encryption_type>,<os_cvm_des>. os_cvm_encryption_type 유효한 값은 EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk입니다.
각 지역에 대한 갤러리 아티팩트에서 OS 및 데이터 디스크를 암호화하기 위한 고객 관리 키의 공간 구분 목록입니다. 각 지역에 대한 형식: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>. 자리 표시자로 "null"을 사용합니다.
공간으로 구분된 지역 목록 및 해당 복제본(replica) 개수입니다. 필요에 따라 각 지역에 대한 복제본(replica) 개수 및/또는 스토리지 계정 유형을 설정하는 데 사용합니다<region>[=<replica count>][=<storage account type>]. 복제본(replica) 개수를 지정하지 않으면 기본 복제본(replica) 수가 사용됩니다. 스토리지 계정 유형을 지정하지 않으면 기본 스토리지 계정 유형이 사용됩니다.
VM 원본의 리소스 ID입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version delete
갤러리 이미지 버전을 삭제합니다.
az sig image-version delete [--gallery-image-definition]
[--gallery-image-version]
[--gallery-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]선택적 매개 변수
이미지 버전이 있는 갤러리 이미지 정의의 이름입니다.
삭제할 갤러리 이미지 버전의 이름입니다.
이미지 정의가 있는 공유 이미지 갤러리의 이름입니다.
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
장기 실행 작업이 완료되기를 기다리지 마세요.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version list
갤러리 이미지 정의에 갤러리 이미지 버전을 나열합니다.
az sig image-version list --gallery-image-definition
--gallery-name
--resource-group
[--max-items]
[--next-token]필수 매개 변수
갤러리 이미지 정의입니다.
갤러리 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
명령의 출력에서 반환할 총 항목 수입니다. 사용 가능한 총 항목 수가 지정된 값보다 많으면 명령의 출력에 토큰이 제공됩니다. 페이지 매김을 다시 시작하려면 후속 명령의 인수에 --next-token 토큰 값을 제공합니다.
페이지 매김을 시작할 위치를 지정하는 토큰입니다. 이는 이전에 잘린 응답의 토큰 값입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version list-community
갤러리 커뮤니티에서 VM 이미지 버전을 나열합니다.
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]예제
갤러리 커뮤니티에서 이미지 버전을 나열합니다.
az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocation선택적 매개 변수
이미지 버전을 나열할 커뮤니티 갤러리 이미지 정의의 이름입니다.
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
다음 목록 작업과 함께 반환할 컨테이너 목록의 부분을 식별하는 문자열 값입니다. 이 작업은 목록 작업이 현재 페이지와 함께 나열될 모든 컨테이너를 다시 반환하지 않으면 응답 본문 내에서 NextMarker 값을 반환합니다기본. 지정한 경우 이 생성기는 이전 생성기가 중지된 지점에서 결과를 반환하기 시작합니다.
커뮤니티 갤러리의 공개 이름입니다.
지정된 경우 결과에 nextMarker를 표시합니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version list-community (image-gallery 확장)
이 명령은 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus
갤러리 커뮤니티(미리 보기)에서 VM 이미지 버전을 나열합니다.
갤러리 커뮤니티에서 VM 이미지 버전을 나열합니다(프라이빗 미리 보기 기능, 이 기능을 사용하려는 경우 미리 보기에 등록하려면 메일 sigpmdev@microsoft.com 로 커뮤니티 이미지 갤러리 팀에 문의하세요).
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]예제
갤러리 커뮤니티에서 이미지 버전을 나열합니다.
az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocation선택적 매개 변수
이미지 버전을 나열할 커뮤니티 갤러리 이미지 정의의 이름입니다.
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
다음 목록 작업과 함께 반환할 컨테이너 목록의 부분을 식별하는 문자열 값입니다. 이 작업은 목록 작업이 현재 페이지와 함께 나열될 모든 컨테이너를 다시 반환하지 않으면 응답 본문 내에서 NextMarker 값을 반환합니다기본. 지정한 경우 이 생성기는 이전 생성기가 중지된 지점에서 결과를 반환하기 시작합니다.
커뮤니티 갤러리의 공개 이름입니다.
지정된 경우 결과에 nextMarker를 표시합니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version list-shared
구독 또는 테넌트에 직접 공유되는 갤러리의 VM 이미지 버전을 나열합니다.
az sig image-version list-shared [--gallery-image-definition]
[--gallery-unique-name]
[--ids]
[--location]
[--marker]
[--shared-to {tenant}]
[--show-next-marker]
[--subscription]예제
지정된 위치 및 이미지 정의에서 구독에 직접 공유되는 갤러리의 이미지 버전을 나열합니다.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation지정된 위치 및 이미지 정의에서 테넌트에 직접 공유되는 갤러리의 이미지 버전을 나열합니다.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation --shared-to tenant선택적 매개 변수
이미지 버전을 나열할 공유 갤러리 이미지 정의의 이름입니다.
공유 갤러리의 고유한 이름입니다.
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
다음 목록 작업과 함께 반환할 컨테이너 목록의 부분을 식별하는 문자열 값입니다. 이 작업은 목록 작업이 현재 페이지와 함께 나열될 모든 컨테이너를 다시 반환하지 않으면 응답 본문 내에서 NextMarker 값을 반환합니다기본. 지정한 경우 이 생성기는 이전 생성기가 중지된 지점에서 결과를 반환하기 시작합니다.
목록 작업을 수행할 때 가져올 공유 갤러리를 결정하는 쿼리 매개 변수입니다. 지정하지 않으면 구독 ID별로 나열합니다.
지정된 경우 결과에 nextMarker를 표시합니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version show
갤러리 이미지 버전에 대한 정보를 검색합니다.
az sig image-version show --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--expand]필수 매개 변수
갤러리 이미지 정의입니다.
의미 체계 버전 패턴의 갤러리 이미지 버전입니다. 허용되는 문자는 숫자와 마침표입니다. 숫자는 32비트 정수 범위 내에 있어야 합니다(예: .). <MajorVersion>.<MinorVersion>.<Patch>
갤러리 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
작업에 적용할 확장 식(예: 'ReplicationStatus')입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version show-community
커뮤니티 갤러리 이미지 버전을 가져옵니다.
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]선택적 매개 변수
이미지 버전을 나열할 커뮤니티 갤러리 이미지 정의의 이름입니다.
의미 체계 버전 패턴의 갤러리 이미지 버전입니다. 허용되는 문자는 숫자와 마침표입니다. 숫자는 32비트 정수 범위 내에 있어야 합니다(예: .). <MajorVersion>.<MinorVersion>.<Patch>
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
커뮤니티 갤러리의 공개 이름입니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version show-community (image-gallery 확장)
이 명령은 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus
갤러리 커뮤니티(미리 보기)에서 이미지 버전을 가져옵니다.
갤러리 커뮤니티에서 이미지 버전을 가져옵니다(비공개 미리 보기 기능, 이 기능을 사용하려는 경우 미리 보기에 등록하려면 메일 sigpmdev@microsoft.com 로 커뮤니티 이미지 갤러리 팀에 문의하세요).
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]예제
지정된 위치의 갤러리 커뮤니티에서 이미지 버전을 가져옵니다.
az sig image-version show-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation선택적 매개 변수
이미지 버전을 나열할 커뮤니티 갤러리 이미지 정의의 이름입니다.
만들 갤러리 이미지 버전의 이름입니다. 의미 체계 버전 이름 패턴을 따라야 합니다. 허용되는 문자는 숫자와 마침표입니다. 숫자는 32비트 정수 범위 내에 있어야 합니다. 형식:...
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
커뮤니티 갤러리의 공개 이름입니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version show-shared
구독 또는 테넌트에 직접 공유되는 갤러리에서 이미지 버전을 가져옵니다.
az sig image-version show-shared [--gallery-image-definition]
[--gallery-image-version]
[--gallery-unique-name]
[--ids]
[--location]
[--subscription]예제
지정된 위치의 구독 또는 테넌트에 직접 공유되는 갤러리의 이미지 버전을 가져옵니다.
az sig image-version show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation선택적 매개 변수
이미지 버전을 나열할 공유 갤러리 이미지 정의의 이름입니다.
만들 갤러리 이미지 버전의 이름입니다. 의미 체계 버전 이름 패턴을 따라야 합니다. 허용되는 문자는 숫자와 마침표입니다. 숫자는 32비트 정수 범위 내에 있어야 합니다. 형식:...
공유 갤러리의 고유한 이름입니다.
하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version undelete
이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus
일시 삭제된 이미지 버전을 복원합니다.
일시 삭제가 설정된 갤러리 내에서 사용하는 경우에만 작업이 성공합니다.
az sig image-version undelete --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--location]
[--no-wait]
[--tags]예제
일시 삭제된 이미지 버전 복원
az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1필수 매개 변수
갤러리 이미지 정의입니다.
의미 체계 버전 패턴의 갤러리 이미지 버전입니다. 허용되는 문자는 숫자와 마침표입니다. 숫자는 32비트 정수 범위 내에 있어야 합니다(예: .). <MajorVersion>.<MinorVersion>.<Patch>
갤러리 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
복제본(replica)ted 지역에서 이 갤러리 이미지 버전을 제거할 수 있는지 여부를 나타냅니다.
위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
장기 실행 작업이 완료되기를 기다리지 마세요.
공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version update
공유 이미지 버전을 업데이트합니다.
az sig image-version update --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--add]
[--allow-replicated-location-deletion {false, true}]
[--force-string]
[--no-wait]
[--remove]
[--replica-count]
[--set]
[--target-edge-zones]
[--target-regions]예제
복제본(replica) 지역 및 복제본(replica) 개수 변경
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-regions westcentralus=2 eastus2복제본(replica) 확장 위치 변경
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1복제본(replica) 확장 위치 지우기
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones None추가 지역에 복제합니다. 선택 사항으로, 지역에 대한 복제본(replica) 개수를 설정하고 최신 버전의 이미지 정의를 사용할 때 이 이미지를 제외할 수 있습니다.
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--add publishingProfile.targetRegions name=westcentralus \
regionalReplicaCount=3 excludeFromLatest=true이미지 정의의 최신 버전을 고려하여 이미지를 포함할지 여부를 변경합니다. 이 값을 true로 설정하면 이미지가 고려 사항에서 제외되고 이 값을 false로 설정하면 고려할 이미지가 포함됩니다.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.excludeFromLatest=true이미지 버전의 수명 종료 날짜를 변경합니다. 수명이 종료된 후에도 이미지를 사용하여 가상 머신을 만들 수 있습니다.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.endOfLifeDate=2024-08-02T00:00:00+00:00복제본(replica)ted 지역에서 갤러리 이미지 버전을 제거할 수 있습니다.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set safetyProfile.allowDeletionOfReplicatedLocations=true필수 매개 변수
갤러리 이미지 정의입니다.
의미 체계 버전 패턴의 갤러리 이미지 버전입니다. 허용되는 문자는 숫자와 마침표입니다. 숫자는 32비트 정수 범위 내에 있어야 합니다(예: .). <MajorVersion>.<MinorVersion>.<Patch>
갤러리 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>
복제본(replica)ted 지역에서 이 갤러리 이미지 버전을 제거할 수 있는지 여부를 나타냅니다.
'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.
장기 실행 작업이 완료되기를 기다리지 마세요.
목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.
지역별로 만들 기본 복제본(replica) 수입니다. 지역 복제본(replica) 횟수를 설정하려면 --target-regions를 사용합니다.
설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>
영역, 에지 영역, 복제본(replica) 개수 및 스토리지 유형의 공간으로 구분된 목록입니다. =[=][=]를 사용하여 필요에 따라 각 지역에 대한 복제본(replica) 개수 및/또는 스토리지 계정 유형을 설정합니다. 복제본(replica) 개수를 지정하지 않으면 기본 복제본(replica) 수가 사용됩니다. 스토리지 계정 유형을 지정하지 않으면 기본 스토리지 계정 유형이 사용됩니다. "--target-edge-zones None"을 지정하면 대상 확장 위치가 지워집니다.
공간으로 구분된 지역 목록 및 해당 복제본(replica) 개수입니다. 필요에 따라 각 지역에 대한 복제본(replica) 개수 및/또는 스토리지 계정 유형을 설정하는 데 사용합니다<region>[=<replica count>][=<storage account type>]. 복제본(replica) 개수를 지정하지 않으면 기본 복제본(replica) 수가 사용됩니다. 스토리지 계정 유형을 지정하지 않으면 기본 스토리지 계정 유형이 사용됩니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az sig image-version wait
이미지 버전 관련 작업을 기다립니다.
az sig image-version wait --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--interval]
[--timeout]
[--updated]예제
이미지 버전이 업데이트되기를 기다립니다.
az sig image-version wait --updated --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0이미지 버전 관련 작업을 기다립니다. (자동 생성됨)
az sig image-version wait --created --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0필수 매개 변수
갤러리 이미지 정의입니다.
의미 체계 버전 패턴의 갤러리 이미지 버전입니다. 허용되는 문자는 숫자와 마침표입니다. 숫자는 32비트 정수 범위 내에 있어야 합니다(예: .). <MajorVersion>.<MinorVersion>.<Patch>
갤러리 이름입니다.
리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.
조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView. 상태es[?code=='PowerState/running'].
삭제될 때까지 기다립니다.
리소스가 존재할 때까지 기다립니다.
작업에 적용할 확장 식입니다. 'ReplicationStatus' 기본값은 None입니다.
폴링 간격(초)입니다.
최대 대기 시간(초)입니다.
'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
Azure CLI