New-AzGalleryImageDefinition
Creare una definizione di immagine della raccolta.
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 $descriptionCrea 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 $descriptionCrea 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 $descriptionCrea 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 $purchasePlanPublisherCrea 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 $endOfLifeDateQuesto 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 $maxVCPUCrea 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 $disallowedDiskTypesCrea 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 $releaseNoteUriCrea 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 $FeaturesCreare una definizione di immagine della raccolta con funzionalità del tipo di sicurezza standard specificando "Nessuno" come valore della funzionalità SecurityType.
Parametri
-Architecture
Architettura della CPU supportata da un disco del sistema operativo. I valori possibili sono "X64" e "Arm64".
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AsJob
Eseguire il cmdlet in background
| Tipo: | SwitchParameter |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Descrizione della risorsa definizione dell'immagine della raccolta.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisallowedDiskType
Tipi di disco non consentiti.
| Tipo: | String[] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EndOfLifeDate
Data di fine vita della raccolta Definizione immagine
| Tipo: | DateTime |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Eula
Contratto di licenza per la definizione dell'immagine della raccolta.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Feature
Elenco delle funzionalità dell'immagine della raccolta. Per SecurityType, gli input accettabili sono: None, TrustedlaunchSupported, Trustedlaunch, ConfidentialVM, ConfidentialVMSupported, TrustedandConfidentialVMSupported
| Tipo: | GalleryImageFeature[] |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryName
Nome della raccolta.
| Tipo: | String |
| Position: | 1 |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HyperVGeneration
Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo. I valori consentiti sono V1 e V2.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
Posizione della risorsa
| Tipo: | String |
| Position: | 3 |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MaximumMemory
Valore massimo della memoria consigliata
| Tipo: | Int32 |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MaximumVCPU
Il massimo del core CPU consigliato
| Tipo: | Int32 |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MinimumMemory
Minimo della memoria consigliata
| Tipo: | Int32 |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MinimumVCPU
Minimo del core CPU consigliato
| Tipo: | Int32 |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Nome della definizione dell'immagine della raccolta.
| Tipo: | String |
| Aliases: | GalleryImageDefinitionName |
| Position: | 2 |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Offer
Nome dell'offerta Image Definition della raccolta.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OsState
Stato del sistema operativo
| Tipo: | OperatingSystemStateTypes |
| valori accettati: | Generalized, Specialized |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OsType
Tipo di sistema operativo
| Tipo: | OperatingSystemTypes |
| valori accettati: | Windows, Linux |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrivacyStatementUri
URI dell'informativa sulla privacy.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Publisher
Nome dell'autore image definition della raccolta.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PurchasePlanName
ID del piano di acquisto.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PurchasePlanProduct
ID prodotto per il piano di acquisto.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PurchasePlanPublisher
ID editore per il piano di acquisto.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReleaseNoteUri
URI della nota di versione.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Nome del gruppo di risorse.
| Tipo: | String |
| Position: | 0 |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Sku
Nome dello SKU Image Definition della raccolta.
| Tipo: | String |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
Tag delle risorse
| Tipo: | Hashtable |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valore predefinito: | None |
| Necessario: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
String[]
Output
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per