Update-AzGalleryImageDefinition

Module:
Az.Compute Module

Mettez à jour une définition d’image de galerie.

Syntaxe

DefaultParameter (Par défaut) 

Update-AzGalleryImageDefinition
    [-ResourceGroupName] <String>
    [-GalleryName] <String>
    [-Name] <String>
    [-AsJob]
    [-Description <String>]
    [-DisallowedDiskType <String[]>]
    [-EndOfLifeDate <DateTime>]
    [-Eula <String>]
    [-MinimumMemory <Int32>]
    [-MinimumVCPU <Int32>]
    [-MaximumMemory <Int32>]
    [-MaximumVCPU <Int32>]
    [-PrivacyStatementUri <String>]
    [-PurchasePlanName <String>]
    [-PurchasePlanProduct <String>]
    [-PurchasePlanPublisher <String>]
    [-ReleaseNoteUri <String>]
    [-Tag <Hashtable>]
    [-Feature <GalleryImageFeature[]>]
    [-AllowUpdateImage <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdParameter 

Update-AzGalleryImageDefinition
    [-ResourceId] <String>
    [-AsJob]
    [-Description <String>]
    [-DisallowedDiskType <String[]>]
    [-EndOfLifeDate <DateTime>]
    [-Eula <String>]
    [-MinimumMemory <Int32>]
    [-MinimumVCPU <Int32>]
    [-MaximumMemory <Int32>]
    [-MaximumVCPU <Int32>]
    [-PrivacyStatementUri <String>]
    [-PurchasePlanName <String>]
    [-PurchasePlanProduct <String>]
    [-PurchasePlanPublisher <String>]
    [-ReleaseNoteUri <String>]
    [-Tag <Hashtable>]
    [-Feature <GalleryImageFeature[]>]
    [-AllowUpdateImage <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectParameter 

Update-AzGalleryImageDefinition
    [-InputObject] <PSGalleryImage>
    [-AsJob]
    [-Description <String>]
    [-DisallowedDiskType <String[]>]
    [-EndOfLifeDate <DateTime>]
    [-Eula <String>]
    [-MinimumMemory <Int32>]
    [-MinimumVCPU <Int32>]
    [-MaximumMemory <Int32>]
    [-MaximumVCPU <Int32>]
    [-PrivacyStatementUri <String>]
    [-PurchasePlanName <String>]
    [-PurchasePlanProduct <String>]
    [-PurchasePlanPublisher <String>]
    [-ReleaseNoteUri <String>]
    [-Tag <Hashtable>]
    [-Feature <GalleryImageFeature[]>]
    [-AllowUpdateImage <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Mettez à jour une définition d’image de galerie.

Exemples

Exemple 1 : Modifier les configurations recommandées pour une définition d’image

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
$minVCPU = 1
$maxVCPU = 4
$minMemory = 1
$maxMemory = 8
$description = "My image definition"
$endOfLifeDate = "2024-08-02T00:00:00+00:00"
Update-AzGalleryImageDefinition -ResourceGroupName $resourceGroupName -GalleryName $galleryName -Name $galleryImageDefinitionName -Description $description -EndOfLifeDate $endOfLifeDate -MinimumMemory $minMemory -MaximumMemory $maxMemory -MinimumVCPU $minVCPU -MaximumVCPU $maxVCPU

Mettre à jour les paramètres de configuration recommandés d’une définition d’image de galerie

Exemple 2 : Mettre à jour les fonctionnalités d’image de la galerie avec StartsAtVersion

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageDefinitionName = "myImageDefinition"
$DiskControllerType = @{Name='DiskControllerTypes'; Value='SCSI'; StartsAtVersion='4.0.0'}
$SecurityType = @{Name='SecurityType'; Value='TrustedLaunch'; StartsAtVersion='4.0.0'}
$features = @($DiskControllerType, $SecurityType)
Update-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $imageDefinitionName -Feature $features -AllowUpdateImage $true

Mettez à jour les fonctionnalités d’une définition d’image de galerie, en définissant la version minimale de l’image de la galerie qui prend en charge chaque fonctionnalité via StartsAtVersion. Le paramètre AllowUpdateImage doit être défini sur true lors de la mise à jour des fonctionnalités.

Paramètres

-AllowUpdateImage

Doit être défini $true sur le moment où les fonctionnalités d’image de la galerie sont mises à jour à l’aide du -Feature paramètre.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-AsJob

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Description

Description de la ressource de définition d’image de la galerie.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DisallowedDiskType

Types de disques non autorisés.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-EndOfLifeDate

Date de fin de vie de la définition d’image de la galerie

Propriétés du paramètre

Type:DateTime
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Eula

Accord Eula pour la définition d’image de la galerie.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Feature

Liste des fonctionnalités d’image de la galerie à mettre à jour. Chaque fonctionnalité peut inclure une propriété StartsAtVersion pour indiquer la version minimale de l’image de galerie qui la prend en charge.

Propriétés du paramètre

Type:

GalleryImageFeature[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-GalleryName

Nom de la galerie.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DefaultParameter
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-InputObject

Objet de définition d’image de la galerie PS.

Propriétés du paramètre

Type:PSGalleryImage
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:GalleryImageDefinition

Jeux de paramètres

ObjectParameter
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaximumMemory

Maximum de la mémoire recommandée

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-MaximumVCPU

Nombre maximal de cœurs d’UC recommandés

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-MinimumMemory

Minimum de la mémoire recommandée

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-MinimumVCPU

Minimum du cœur de processeur recommandé

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:GalleryImageDefinitionName

Jeux de paramètres

DefaultParameter
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PrivacyStatementUri

URI de déclaration de confidentialité.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PurchasePlanName

ID du plan d’achat.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PurchasePlanProduct

ID de produit du plan d’achat.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PurchasePlanPublisher

ID de l’éditeur pour le plan d’achat.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ReleaseNoteUri

URI de note de publication.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DefaultParameter
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ResourceId

ID de ressource de la définition d’image

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ResourceIdParameter
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Tag

Étiquettes de ressources

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

PSGalleryImage

DateTime

Hashtable

Int32

String

GalleryImageFeature

Boolean

Sorties

PSGalleryImage