Delen via

Update-AzGalleryImageVersion

  • Referentie
Module:
Az.Compute

Een versie van een galerie-installatiekopieën bijwerken.

Syntaxis

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

Een versie van een galerie-installatiekopieën bijwerken.

Voorbeelden

Voorbeeld 1: de replicatieregio's en het aantal replica's wijzigen

$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

Werk de regio's van de installatiekopieën van een galerie-installatiekopieën bij.

Voorbeeld 2: Wijzigen of een installatiekopieënversie moet worden overwogen voor de meest recente versie.

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

De versie van een galerie-installatiekopieën wordt uitgesloten van de meest recente status. Als u een installatiekopieënversie in overweging wilt nemen voor de nieuwste versie, gebruikt u -PublishingProfileExcludeFromLatest:$false. Als u een versie van een installatiekopieën wilt uitsluiten van overweging voor de meest recente versie, gebruikt u -PublishingProfileExcludeFromLatest.

Voorbeeld 3: De einddatum van een installatiekopieënversie wijzigen.

$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

Werk de einddatum van een installatiekopieënversie van een galerie bij. De versie van de installatiekopieën kan nog steeds worden gebruikt om virtuele machines te maken na de einddatum van de levensduur.

Voorbeeld 4: Bijwerken om TargetExtendedLocations te verwijderen.

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

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

Werk een versie van de galerie-installatiekopieën bij om bestaande uitgebreide doellocaties te verwijderen. Geef een lege matrix door voor -TargetExtendedLocation en stel -AllowDeletionOfReplicatedLocation in op true.

Parameters

-AllowDeletionOfReplicatedLocation

Hiermee wordt aangegeven of het verwijderen van deze installatiekopieënversie van de galerie uit gerepliceerde regio's is toegestaan.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-GalleryImageDefinitionName

De naam van de definitie van de galerie-installatiekopieën.

Type:String
Aliassen:GalleryImageName
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-GalleryName

De naam van de galerie.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InputObject

Het versieobject van de PS Gallery-installatiekopieën.

Type:PSGalleryImageVersion
Aliassen:GalleryImageVersion
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van de installatiekopieënversie van de galerie.

Type:String
Aliassen:GalleryImageVersionName
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PublishingProfileEndOfLifeDate

De einddatum van de levensduur van de galerie Image Version.

Type:DateTime
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PublishingProfileExcludeFromLatest

Als deze is ingesteld, worden virtuele machines die zijn geïmplementeerd vanuit de nieuwste versie van de definitie van de installatiekopie, deze installatiekopieversie niet gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ReplicaCount

Het aantal replica's van de versie van de installatiekopieën dat per regio moet worden gemaakt.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceId

De resource-id voor de installatiekopieënversie van de galerie.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

Resourcetags

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TargetExtendedLocation

De uitgebreide doellocaties waarnaar de versie van de installatiekopieën wordt gerepliceerd. Deze eigenschap kan worden bijgewerkt.

Type:Hashtable[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TargetRegion

De doelregio's waarnaar de versie van de installatiekopieën wordt gerepliceerd.

Type:Hashtable[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

PSGalleryImageVersion

Hashtable

Int32

SwitchParameter

DateTime

Hashtable[]

Uitvoerwaarden

PSGalleryImageVersion