New-AzGalleryImageDefinition

Sintassi

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>]

Descrizione

Creare una definizione di immagine della raccolta. Per impostazione predefinita, la definizione dell'immagine della raccolta sarà 'HyperVGeneration: V2' e 'SecurityType: TrustedLaunchSupported' se -HyperVGeneration e -Feature @{Name: SecurityType} non è impostata in modo esplicito. Impostare SecurityType su "Nessuno" per rifiutare esplicitamente questa impostazione predefinita (vedere l'esempio 10).

Esempio

Esempio 1: Creare una definizione di immagine per immagini Linux specializzate

$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

Crea una definizione di immagine della raccolta per contenere versioni di immagini per immagini Linux specializzate. Per impostazione predefinita, l'immagine della raccolta viene impostata su HyperVGeneration V2 e Avvio attendibile come -HyperVGeneration e -Feature SecurityType non è impostata in modo esplicito.

Esempio 2: Creare una definizione di immagine per immagini Linux generalizzate

$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

Crea una definizione di immagine della raccolta per contenere versioni di immagini per immagini Linux generalizzate.

Esempio 3: Creare una definizione di immagine per immagini windows specializzate

$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

Crea una definizione di immagine della raccolta per contenere le versioni delle immagini per immagini windows specializzate.

Esempio 4: Creare una definizione di immagine per immagini windows generalizzate e impostare le funzionalità.

$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"

Crea una definizione di immagine della raccolta in modo da contenere le versioni delle immagini immagine per le immagini windows generalizzate.

Esempio 5: Creare una definizione di immagine con informazioni sul piano

$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

Crea una definizione di immagine della raccolta per immagini generalizzate linux e definisce il nome del piano, il prodotto e l'editore. A questa definizione è possibile aggiungere solo le versioni dell'immagine che corrispondono alle informazioni sul piano.

Esempio 6: Creare una definizione di immagine e indicare la fine della data di vita

$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

Questo esempio ha la data di fine vita per le definizioni di immagine impostata sul 2 agosto 2024 alle ore UTC di mignight. Le date di fine vita possono essere specificate per le definizioni delle immagini e le versioni delle immagini. Le definizioni delle immagini possono comunque essere usate dopo le date di fine vita.

Esempio 7: Creare una definizione di immagine e consigliare cpu e memoria minima e massima (GB)

$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

Crea una definizione di immagine della raccolta e consiglia gli intervalli minimi e massimi per la CPU e la memoria supportati dalle versioni dell'immagine in questa definizione di immagine. Le versioni delle immagini possono comunque essere usate per creare macchine virtuali con impostazioni di memoria e vCPU al di fuori degli intervalli consigliati.

Esempio 8: Creare una definizione di immagine e indicare quali tipi di disco del sistema operativo non sono consigliati per l'immagine

$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

Crea una definizione di immagine della raccolta e indica i tipi di disco del sistema operativo che potrebbero non essere compatibili con le versioni dell'immagine all'interno di questa definizione di immagine. Le versioni delle immagini possono comunque essere usate per creare macchine virtuali con un disco del sistema operativo che è uno dei tipi di disco non consentiti.

Esempio 9: Creare una definizione di immagine e fornire l'URI delle note sulla privacy, l'URI dell'informativa sulla privacy e l'URI delle note sulla versione

$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

Crea una definizione di immagine della raccolta per le immagini generalizzate linux e specifica la stringa o il percorso di un contratto di licenza, un'informativa sulla privacy e le note sulla versione associate a tutte le versioni delle immagini nella definizione dell'immagine.

Esempio 10: Creare una definizione di immagine della raccolta con la funzionalità Standard SecurityType

$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

Creare una definizione di immagine della raccolta con funzionalità del tipo di sicurezza standard specificando "Nessuno" come valore della funzionalità SecurityType.

Parametri

-Architecture

-AsJob

-Confirm

-DefaultProfile

-Description

-DisallowedDiskType

-EndOfLifeDate

-Eula

-Feature

-GalleryName

-HyperVGeneration

-Location

-MaximumMemory

-MaximumVCPU

-MinimumMemory

-MinimumVCPU

-Name

-Offer

-OsState

-OsType

-PrivacyStatementUri

-Publisher

-PurchasePlanName

-PurchasePlanProduct

-PurchasePlanPublisher

-ReleaseNoteUri

-ResourceGroupName

-Sku

-Tag

-WhatIf

Input

String

OperatingSystemStateTypes

OperatingSystemTypes

DateTime

Hashtable

Int32

String[]

Output

PSGalleryImage