Update-AzGalleryImageVersion

Mettez à jour une version d’image de la galerie.

Syntax

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

Mettez à jour une version d’image de la galerie.

Exemples

Exemple 1 : Modifier les régions de réplication et le nombre de réplicas

$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

Mettez à jour les régions d’une version d’image de galerie.

Exemple 2 : Modifier si une version d’image doit être prise en compte pour la dernière version.

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

Mettez à jour l’exclusion de la version d’une image de galerie par rapport à l’état le plus récent. Pour inclure une version d’image en considération pour la dernière version, utilisez -PublishingProfileExcludeFromLatest:$false. Pour exclure une version d’image à prendre en compte pour la dernière version, utilisez -PublishingProfileExcludeFromLatest.

Exemple 3 : Modifier la date de fin de vie d’une version d’image.

$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

Mettez à jour la date de fin de vie d’une version d’image de la galerie. La version de l’image peut toujours être utilisée pour créer des machines virtuelles après la date de fin de vie.

Exemple 4 : Mise à jour pour supprimer TargetExtendedLocations.

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

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

Mettez à jour une version d’image de galerie pour supprimer les emplacements étendus cibles existants. Transmettez un tableau vide pour -TargetExtendedLocation et définissez -AllowDeletionOfReplicatedLocation sur true.

Paramètres

-AllowDeletionOfReplicatedLocation

Indique si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AsJob

Exécuter l’applet de commande en arrière-plan

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

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

-GalleryImageDefinitionName

Nom de la définition d’image de la galerie.

Type:String
Aliases:GalleryImageName
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-GalleryName

Nom de la galerie.

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

-InputObject

Objet de version d’image de la galerie PS.

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

-Name

Nom de la version de l’image de la galerie.

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

-PublishingProfileEndOfLifeDate

Date de fin de vie de la version d’image de la galerie.

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

-PublishingProfileExcludeFromLatest

S’il est défini, Machines Virtuelles déployé à partir de la dernière version de la définition d’image n’utilise pas cette version d’image.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ReplicaCount

Nombre de réplicas de la version d’image à créer par région.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Nom du groupe de ressources.

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

-ResourceId

ID de ressource de la version de l’image de la galerie.

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

-Tag

Balises de ressource

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

-TargetExtendedLocation

Emplacements étendus cibles vers lesquels la version de l’image doit être répliquée. Cette propriété est pouvant être mise à jour.

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

-TargetRegion

Régions cibles vers lesquelles la version de l’image sera répliquée.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

String

PSGalleryImageVersion

Hashtable

Int32

SwitchParameter

DateTime

Hashtable[]

Sorties

PSGalleryImageVersion