New-AzGalleryImageDefinition
Créez une définition d’image de galerie.
Syntaxe
Default (Par défaut)
New-AzGalleryImageDefinition
[-ResourceGroupName] <String>
[-GalleryName] <String>
[-Name] <String>
[-AsJob]
[-Location] <String>
-Publisher <String>
-Offer <String>
-Sku <String>
-OsState <OperatingSystemStateTypes>
-OsType <OperatingSystemTypes>
[-Description <String>]
[-DisallowedDiskType <String[]>]
[-EndOfLifeDate <DateTime>]
[-Eula <String>]
[-HyperVGeneration <String>]
[-MinimumMemory <Int32>]
[-MinimumVCPU <Int32>]
[-MaximumMemory <Int32>]
[-MaximumVCPU <Int32>]
[-PrivacyStatementUri <String>]
[-PurchasePlanName <String>]
[-PurchasePlanProduct <String>]
[-PurchasePlanPublisher <String>]
[-ReleaseNoteUri <String>]
[-Tag <Hashtable>]
[-Feature <GalleryImageFeature[]>]
[-Architecture <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Créez une définition d’image de galerie.
La définition d’image de la galerie est définie par défaut sur « HyperVGeneration : V2 » et « SecurityType : TrustedLaunchSupported » si -HyperVGeneration elle n’est -Feature @{Name: SecurityType} pas définie explicitement. Définissez SecurityType sur « None » pour refuser cette valeur par défaut (voir l’exemple 10).
Exemples
Exemple 1 : Créer une définition d’image pour les images Linux spécialisées
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$description = "My gallery"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Specialized" -OsType "Linux" -Description $description
Crée une définition d’image de galerie pour contenir des versions d’images pour des images Linux spécialisées. L’image de la galerie est définie par défaut sur HyperVGeneration V2 et le lancement approuvé, car -HyperVGeneration elle -Feature SecurityType n’est pas définie explicitement.
Exemple 2 : Créer une définition d’image pour les images Linux généralisées
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$description = "My gallery"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -Description $description
Crée une définition d’image de galerie pour contenir des versions d’images pour les images Linux généralisées.
Exemple 3 : Créer une définition d’image pour les images Windows spécialisées
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$description = "My gallery"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Specialized" -OsType "Windows" -Description $description
Crée une définition d’image de galerie pour contenir des versions d’image pour les images windows spécialisées.
Exemple 4 : Créez une définition d’image pour les images windows généralisées et définissez des fonctionnalités.
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$description = "My gallery"
$IsHibernateSupported = @{Name='IsHibernateSupported';Value='True'}
$IsAcceleratedNetworkSupported = @{Name='IsAcceleratedNetworkSupported';Value='False'}
$ConfidentialVMSupported = @{Name='SecurityType';Value='ConfidentialVMSupported'}
$features = @($IsHibernateSupported,$IsAcceleratedNetworkSupported, $ConfidentialVMSupported)
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Windows" -Description $description -Feature $features -HyperVGeneration "V2"
Crée une définition d’image de galerie pour contenir des versions d’image pour les images windows généralisées.
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$purchasePlanName = "myPlanName"
$purchasePlanProduct = "myPlanProduct"
$purchasePlanPublisher = "myPlanPublisher"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -PurchasePlanName $purchasePlanName -PurchasePlanProduct $purchasePlanProduct -PurchasePlanPublisher $purchasePlanPublisher
Crée une définition d’image de galerie pour les images généralisées Linux et définit le nom du plan, le produit et l’éditeur. Seules les versions d’image qui correspondent aux informations du plan peuvent être ajoutées à cette définition.
Exemple 6 : Créer une définition d’image et indiquer la date de fin de vie
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$endOfLifeDate = "2024-08-02T00:00:00+00:00"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -EndOfLifeDate $endOfLifeDate
Cet exemple présente la date de fin de vie des définitions d’image définie sur le 2 août 2024 à minuit UTC. Les dates de fin de vie peuvent être spécifiées pour les définitions d’image et les versions d’image. Les définitions d’image peuvent toujours être utilisées après les dates de fin de vie.
Exemple 7 : Créer une définition d’image et recommander le processeur et la mémoire minimales et maximales (Go)
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$minMemory = 32
$maxMemory = 128
$minVCPU = 2
$maxVCPU = 8
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -MinimumMemory $minMemory -MaximumMemory $maxMemory -MinimumVCPU $minVCPU -MaximumVCPU $maxVCPU
Crée une définition d’image de galerie et recommande les plages minimales et maximales pour le processeur et la mémoire que les versions d’image de cette définition d’image prennent en charge. Les versions d’image peuvent toujours être utilisées pour créer des machines virtuelles avec des paramètres de mémoire et de processeur virtuel en dehors des plages recommandées.
Exemple 8 : Créer une définition d’image et indiquer quels types de disques de système d’exploitation ne sont pas recommandés pour l’image
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$disallowedDiskTypes = @("Standard_LRS")
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -DisallowedDiskType $disallowedDiskTypes
Crée une définition d’image de galerie et indique quels types de disques de système d’exploitation peuvent ne pas être compatibles avec les versions d’image dans cette définition d’image. Les versions d’image peuvent toujours être utilisées pour créer des machines virtuelles avec un disque de système d’exploitation qui est l’un des types de disques non autorisés.
Exemple 9 : Créer une définition d’image et fournir le CLUF, l’URI de déclaration de confidentialité et l’URI des notes de publication
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$eula = "https://myeula"
$privacyStatementUri = "https://mystatement"
$releaseNoteUri = "https://myreleasenotes"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -Eula $eula -PrivacyStatementUri $privacyStatementUri -ReleaseNoteUri $releaseNoteUri
Crée une définition d’image de galerie pour les images généralisées Linux et spécifie la chaîne ou le chemin d’accès à un contrat CLUF, une déclaration de confidentialité et des notes de publication liées à toutes les versions d’image de la définition d’image.
Exemple 10 : Créer une définition d’image de galerie avec la fonctionnalité SecurityType Standard
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$Feature1 = @{Name='SecurityType';Value='None'}
$Features = @($Feature1)
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -Feature $Features
Créez une définition d’image de galerie avec une fonctionnalité de type de sécurité standard en fournissant « None » comme valeur de la fonctionnalité SecurityType.
Paramètres
-Architecture
Architecture du processeur prise en charge par un disque de système d’exploitation. Les valeurs possibles sont « X64 » et « Arm64 ».
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
-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.
Pour SecurityType, les entrées acceptables sont : None, TrustedlaunchSupported, Trustedlaunch, ConfidentialVMSupported, TrustedLaunchAndConfidentialVmSupported
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
(All)
Position: 1
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: True
Valeur des arguments restants: False
-HyperVGeneration
Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation. Les valeurs autorisées sont V1 et V2.
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
-Location
Emplacement des 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
(All)
Position: 3
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: True
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
(All)
Position: 2
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: True
Valeur des arguments restants: False
-Offer
Nom de l’offre 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: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: True
Valeur des arguments restants: False
-OsState
État du système d’exploitation
Propriétés du paramètre
Type: OperatingSystemStateTypes
Valeur par défaut: None
Valeurs acceptées: Generalized, Specialized
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
(All)
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: True
Valeur des arguments restants: False
-OsType
Type de système d’exploitation
Propriétés du paramètre
Type: OperatingSystemTypes
Valeur par défaut: None
Valeurs acceptées: Windows, Linux
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
(All)
Position: Named
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
-Publisher
Nom de l’éditeur 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: True
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
(All)
Position: 0
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: True
Valeur des arguments restants: False
-Sku
Nom de la référence SKU 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: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: True
Valeur des arguments restants: False
-Tag
Balises 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 .
Sorties