Update-AzGalleryImageVersion

Een versie van de galerie-installatiekopieën bijwerken.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

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

Description

Een versie van de 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 een galerie-installatiekopieën bij.

Voorbeeld 2: Wijzig of een versie van de installatiekopieën 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 wilt opnemen in overweging voor de meest recente 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 de galerie bij. De versie van de installatiekopieën kan nog steeds worden gebruikt om virtuele machines te maken na de einddatum van de levensduur.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-GalleryImageDefinitionName

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

Type:String
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-GalleryName

De naam van de galerie.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-InputObject

Het ps Gallery Image Version-object.

Type:PSGalleryImageVersion
Aliases:GalleryImageVersion
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

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

Type:String
Aliases:GalleryImageVersionName
Position:3
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PublishingProfileEndOfLifeDate

De einddatum van de levensduur van de installatiekopieënversie van de galerie.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PublishingProfileExcludeFromLatest

Als deze is ingesteld, gebruikt Virtual Machines geïmplementeerd vanuit de nieuwste versie van de installatiekopiedefinitie deze versie van de installatiekopie niet.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False
-ResourceGroupName

De naam van de resourcegroep.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ResourceId

De resource-id voor de versie van de galerie-installatiekopieën.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Tag

Resourcetags

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-TargetRegion

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

Type:Hashtable[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

PSGalleryImageVersion

Hashtable

Int32

SwitchParameter

DateTime

Hashtable[]

Uitvoerwaarden

PSGalleryImageVersion