Update-AzGalleryImageVersion
Galeri görüntüsü sürümünü güncelleştirme.
Syntax
DefaultParameter (Varsayılan)
Update-AzGalleryImageVersion
[-ResourceGroupName] <String>
[-GalleryName] <String>
[-GalleryImageDefinitionName] <String>
[-Name] <String>
[-AsJob]
[-PublishingProfileEndOfLifeDate <DateTime>]
[-PublishingProfileExcludeFromLatest]
[-ReplicaCount <Int32>]
[-Tag <Hashtable>]
[-TargetRegion <Hashtable[]>]
[-TargetExtendedLocation <Hashtable[]>]
[-AllowDeletionOfReplicatedLocation <Boolean>]
[-BlockDeletionBeforeEndOfLife <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ResourceIdParameter
Update-AzGalleryImageVersion
[-ResourceId] <String>
[-AsJob]
[-PublishingProfileEndOfLifeDate <DateTime>]
[-PublishingProfileExcludeFromLatest]
[-ReplicaCount <Int32>]
[-Tag <Hashtable>]
[-TargetRegion <Hashtable[]>]
[-TargetExtendedLocation <Hashtable[]>]
[-AllowDeletionOfReplicatedLocation <Boolean>]
[-BlockDeletionBeforeEndOfLife <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ObjectParameter
Update-AzGalleryImageVersion
[-InputObject] <PSGalleryImageVersion>
[-AsJob]
[-PublishingProfileEndOfLifeDate <DateTime>]
[-PublishingProfileExcludeFromLatest]
[-ReplicaCount <Int32>]
[-Tag <Hashtable>]
[-TargetRegion <Hashtable[]>]
[-TargetExtendedLocation <Hashtable[]>]
[-AllowDeletionOfReplicatedLocation <Boolean>]
[-BlockDeletionBeforeEndOfLife <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Galeri görüntüsü sürümünü güncelleştirme.
Örnekler
Örnek 1: Çoğaltma bölgelerini ve çoğaltma sayısını değiştirme
$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
Galeri görüntüsü sürümünün bölgelerini güncelleştirme.
Örnek 2: Görüntü sürümünün en son sürüm olarak dikkate alınıp alınmayacağını değiştirin.
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -PublishingProfileExcludeFromLatest:$false
Galeri görüntüsü sürümünün en son durumdan dışlama durumunu güncelleştirin. En son sürümde dikkate alınacak bir görüntü sürümü eklemek için kullanın -PublishingProfileExcludeFromLatest:$false. Bir görüntü sürümünü en son sürümde dikkate alınmadan hariç tutmak için kullanın -PublishingProfileExcludeFromLatest.
Örnek 3: Görüntü sürümünün kullanım süresi sonu tarihini değiştirme.
$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
Galeri görüntüsü sürümünün kullanım süresi sonu tarihini güncelleştirin. Görüntü sürümü, kullanım süresi sonu tarihinden sonra sanal makineler oluşturmak için kullanılabilir.
Örnek 4: TargetExtendedLocations'ı kaldırmak için güncelleştirin.
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -TargetExtendedLocation @() -AllowDeletionOfReplicatedLocation $True
Mevcut hedef genişletilmiş konumları kaldırmak için galeri görüntüsü sürümünü güncelleştirin. -TargetExtendedLocation için boş bir dizi geçirin ve -AllowDeletionOfReplicatedLocation true olarak ayarlayın.
Parametreler
-AllowDeletionOfReplicatedLocation
Çoğaltılan bölgelerden bu Galeri Görüntüsü Sürümünün kaldırılmasına izin verilip verilmediğini gösterir.
Parametre özellikleri
Tür: Boolean
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-AsJob
Cmdlet'i arka planda çalıştırma
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-BlockDeletionBeforeEndOfLife
Bu boole değeri, yanlışlıkla yapılan silme işlemlerinden GalleryImageVersion kaynaklarını etkinleştirmek için müşteriler tarafından geçirilir. Bu boole değeri true olarak ayarlanırsa, görüntü silme işlemleri EndOfLife tarihinden önce engellenir.
Parametre özellikleri
Tür: Nullable<T> [ Boolean ]
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: Cf
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Parametre özellikleri
Tür: IAzureContextContainer
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: AzContext, AzureRmContext, AzureCredential
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-GalleryImageDefinitionName
Galeri görüntüsü tanımının adı.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: GalleryImageName
Parametre kümeleri
DefaultParameter
Position: 2 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-GalleryName
Galerinin adı.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
DefaultParameter
Position: 1 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
PS Galerisi Görüntü Sürümü Nesnesi.
Tür: PSGalleryImageVersion
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: GalleryImageVersion
ObjectParameter
Position: 0 Zorunlu: True İşlem hattından gelen değer: True Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-Name
Galeri görüntüsü sürümünün adı.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: GalleryImageVersionName
Parametre kümeleri
DefaultParameter
Position: 3 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-PublishingProfileEndOfLifeDate
Galerinin kullanım ömrü sonu tarihi Görüntü Sürümü.
Parametre özellikleri
Tür: DateTime
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-PublishingProfileExcludeFromLatest
Ayarlanırsa, Görüntü Tanımının en son sürümünden dağıtılan Sanal Makineler bu Görüntü Sürümünü kullanmaz.
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-ReplicaCount
Bölge başına oluşturulacak Görüntü Sürümünün çoğaltma sayısı.
Parametre özellikleri
Tür: Int32
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-ResourceGroupName
Kaynak grubunun adı.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
DefaultParameter
Position: 0 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-ResourceId
Galeri görüntüsü sürümü için kaynak kimliği.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
ResourceIdParameter
Position: 0 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-Tag
Kaynak etiketleri
Parametre özellikleri
Tür: Hashtable
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-TargetExtendedLocation
Görüntü Sürümünün çoğaltılacağı hedef genişletilmiş konumlar. Bu özellik güncelleştirilebilir.
Parametre özellikleri
Tür: Hashtable [ ]
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-TargetRegion
Görüntü Sürümünün çoğaltılacağı hedef bölgeler.
Parametre özellikleri
Tür: Hashtable [ ]
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir.
Cmdlet çalıştırılmaz.
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: Wi
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters .
Çıkışlar