다음을 통해 공유


Update-AzGalleryImageVersion

갤러리 이미지 버전을 업데이트합니다.

구문

Update-AzGalleryImageVersion
      [-ResourceGroupName] <String>
      [-GalleryName] <String>
      [-GalleryImageDefinitionName] <String>
      [-Name] <String>
      [-AsJob]
      [-PublishingProfileEndOfLifeDate <DateTime>]
      [-PublishingProfileExcludeFromLatest]
      [-ReplicaCount <Int32>]
      [-Tag <Hashtable>]
      [-TargetRegion <Hashtable[]>]
      [-TargetExtendedLocation <Hashtable[]>]
      [-AllowDeletionOfReplicatedLocation <Boolean>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzGalleryImageVersion
      [-ResourceId] <String>
      [-AsJob]
      [-PublishingProfileEndOfLifeDate <DateTime>]
      [-PublishingProfileExcludeFromLatest]
      [-ReplicaCount <Int32>]
      [-Tag <Hashtable>]
      [-TargetRegion <Hashtable[]>]
      [-TargetExtendedLocation <Hashtable[]>]
      [-AllowDeletionOfReplicatedLocation <Boolean>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzGalleryImageVersion
      [-InputObject] <PSGalleryImageVersion>
      [-AsJob]
      [-PublishingProfileEndOfLifeDate <DateTime>]
      [-PublishingProfileExcludeFromLatest]
      [-ReplicaCount <Int32>]
      [-Tag <Hashtable>]
      [-TargetRegion <Hashtable[]>]
      [-TargetExtendedLocation <Hashtable[]>]
      [-AllowDeletionOfReplicatedLocation <Boolean>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

갤러리 이미지 버전을 업데이트합니다.

예제

예제 1: 복제 지역 및 복제본 수 변경

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
$region1 = @{Name='West US';ReplicaCount=1}
$region2 = @{Name='East US';ReplicaCount=2}
$region3 = @{Name='Central US'}
$targetRegions = @($region1,$region2,$region3)
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -ReplicaCount 2 -TargetRegion $targetRegions

갤러리 이미지 버전의 지역을 업데이트합니다.

예제 2: 이미지 버전을 최신 버전으로 간주할지 여부를 변경합니다.

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -PublishingProfileExcludeFromLatest:$false

갤러리 이미지 버전의 제외를 최신 상태에서 업데이트합니다. 최신 버전에 대한 고려 사항에 이미지 버전을 포함하려면 .를 사용합니다 -PublishingProfileExcludeFromLatest:$false. 최신 버전에 대한 고려 사항에서 이미지 버전을 제외하려면 .를 사용합니다 -PublishingProfileExcludeFromLatest.

예제 3: 이미지 버전의 수명 종료 날짜를 변경합니다.

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
$endOfLifeDate = "2024-08-02T00:00:00+00:00"
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -PublishingProfileEndOfLifeDate $endOfLifeDate

갤러리 이미지 버전의 수명 종료 날짜를 업데이트합니다. 이미지 버전은 수명이 종료된 후에도 가상 머신을 만드는 데 계속 사용할 수 있습니다.

예제 4: TargetExtendedLocations를 제거하도록 업데이트합니다.

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"

Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -TargetExtendedLocation @() -AllowDeletionOfReplicatedLocation $True

갤러리 이미지 버전을 업데이트하여 기존 대상 확장 위치를 제거합니다. -TargetExtendedLocation에 대해 빈 배열을 전달하고 -AllowDeletionOfReplicatedLocation을 true로 설정합니다.

매개 변수

-AllowDeletionOfReplicatedLocation

복제된 지역에서 이 갤러리 이미지 버전을 제거할 수 있는지 여부를 나타냅니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-AsJob

백그라운드에서 cmdlet 실행

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-GalleryImageDefinitionName

갤러리 이미지 정의의 이름입니다.

형식:String
별칭:GalleryImageName
Position:2
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-GalleryName

갤러리의 이름입니다.

형식:String
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-InputObject

PS 갤러리 이미지 버전 개체입니다.

형식:PSGalleryImageVersion
별칭:GalleryImageVersion
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

갤러리 이미지 버전의 이름입니다.

형식:String
별칭:GalleryImageVersionName
Position:3
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PublishingProfileEndOfLifeDate

갤러리 이미지 버전의 수명 종료 날짜입니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PublishingProfileExcludeFromLatest

설정된 경우 최신 버전의 이미지 정의에서 배포된 Virtual Machines는 이 이미지 버전을 사용하지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ReplicaCount

지역별로 만들 이미지 버전의 복제본 수입니다.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceGroupName

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

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceId

갤러리 이미지 버전의 리소스 ID입니다.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Tag

리소스 태그

형식:Hashtable
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TargetExtendedLocation

이미지 버전이 복제될 대상 확장 위치입니다. 이 속성은 업데이트할 수 있습니다.

형식:Hashtable[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TargetRegion

이미지 버전이 복제될 대상 지역입니다.

형식:Hashtable[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

PSGalleryImageVersion

Hashtable

Int32

SwitchParameter

DateTime

Hashtable[]

출력

PSGalleryImageVersion