New-AzGalleryImageDefinition

Referentie

Module:: Az.Compute

Maak een definitie van een galerie-installatiekopieën.

Syntaxis

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

Maak een definitie van een galerie-installatiekopieën. De definitie van de galerie-installatiekopieën wordt standaard ingesteld op HyperVGeneration: V2 en SecurityType: TrustedLaunchSupported als -HyperVGeneration en -Feature @{Name: SecurityType} niet expliciet is ingesteld. Stel SecurityType in op Geen om u af te wijzen voor deze standaardinstelling (zie voorbeeld 10).

Voorbeelden

Voorbeeld 1: Een installatiekopieëndefinitie maken voor gespecialiseerde Linux-installatiekopieën

$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

Hiermee maakt u een definitie van een galerie-installatiekopieën om installatiekopieën voor gespecialiseerde Linux-installatiekopieën te bevatten. Hiermee wordt de galerie-installatiekopieën standaard ingesteld op HyperVGeneration V2 en Vertrouwd starten als -HyperVGeneration en -Feature SecurityType niet expliciet is ingesteld.

Voorbeeld 2: Een installatiekopieëndefinitie maken voor gegeneraliseerde Linux-installatiekopieën

$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

Hiermee maakt u een definitie van een galerie-installatiekopieën om installatiekopieën voor gegeneraliseerde Linux-installatiekopieën te bevatten.

Voorbeeld 3: Een installatiekopieëndefinitie maken voor gespecialiseerde Windows-installatiekopieën

$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

Hiermee maakt u een definitie van een galerie-installatiekopieën om installatiekopieën voor gespecialiseerde Windows-installatiekopieën te bevatten.

Voorbeeld 4: Maak een installatiekopieëndefinitie voor gegeneraliseerde Windows-installatiekopieën en stel functies in.

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

Hiermee maakt u een definitie van een galerie-installatiekopieën om installatiekopieën voor gegeneraliseerde Windows-installatiekopieën te bevatten.

Voorbeeld 5: Een definitie van een installatiekopieën maken met plangegevens

$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

Hiermee maakt u een definitie van een galerie-installatiekopieën voor gegeneraliseerde Linux-installatiekopieën en definieert u de naam, het product en de uitgever van het plan. Alleen installatiekopieën die overeenkomen met de plangegevens kunnen aan deze definitie worden toegevoegd.

Voorbeeld 6: Een afbeeldingsdefinitie maken en het einde van de levensduur aangeven

$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

In dit voorbeeld is de einddatum voor afbeeldingsdefinities ingesteld op 2 augustus 2024 om mignight UTC. Einddatums kunnen worden opgegeven voor installatiekopieëndefinities en installatiekopieën. Afbeeldingsdefinities kunnen nog steeds worden gebruikt na de einddatums van de levensduur.

Voorbeeld 7: Een definitie van een installatiekopieën maken en minimale en maximale CPU en geheugen (GB) aanbevelen

$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

Hiermee maakt u een definitie van een galerie-installatiekopieën en wordt het minimum- en maximumbereik aanbevolen voor de CPU en het geheugen die door de installatiekopieën in deze installatiekopieëndefinitie worden ondersteund. Installatiekopieën kunnen nog steeds worden gebruikt om virtuele machines te maken met geheugen- en vCPU-instellingen buiten de aanbevolen bereiken.

Voorbeeld 8: Maak een installatiekopieëndefinitie en geef aan welke schijftypen van het besturingssysteem niet worden aanbevolen voor de installatiekopieën

$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

Hiermee maakt u een definitie van een galerie-installatiekopieën en geeft u aan welke typen besturingssysteemschijven mogelijk niet compatibel zijn met installatiekopieën in deze installatiekopieëndefinitie. Installatiekopieën kunnen nog steeds worden gebruikt om virtuele machines te maken met een besturingssysteemschijf die een van de niet-toegestane schijftypen is.

Voorbeeld 9: Een definitie van een installatiekopie maken en de gebruiksrechtovereenkomst, de URI van de privacyverklaring en de opmerkingen bij de release URI opgeven

$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

Hiermee maakt u een definitie van een galerie-installatiekopie voor gegeneraliseerde Linux-installatiekopieën en geeft u de tekenreeks of het pad op naar een gebruiksrechtovereenkomst, privacyverklaring en releaseopmerkingen die zijn gekoppeld aan alle versies van de installatiekopie in de definitie van de installatiekopie.

Voorbeeld 10: Een definitie van een galerie-installatiekopieën maken met de functie 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

Maak een installatiekopiedefinitie in de galerie met een standaardfunctie voor beveiligingstypen door 'Geen' op te geven als de waarde van de SecurityType-functie.

Parameters

-Architecture

CPU-architectuur die wordt ondersteund door een besturingssysteemschijf. Mogelijke waarden zijn X64 en Arm64.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Description

De beschrijving van de definitieresource van de galerieafbeelding.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DisallowedDiskType

De niet-toegestane schijftypen.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-EndOfLifeDate

De einddatum van de levensduur van de galerie Image Definition

Type:	DateTime
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Eula

De Eula-overeenkomst voor de galerie Image Definition.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Feature

Een lijst met afbeeldingsfuncties in de galerie. Voor SecurityType zijn acceptabele invoer: Geen, TrustedlaunchSupported, Trustedlaunch, ConfidentialVM, ConfidentialVMSupported, TrustedLaunchAndConfidentialVmSupported

Type:	GalleryImageFeature[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-GalleryName

De naam van de galerie.

Type:	String
Position:	1
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-HyperVGeneration

De hypervisorgeneratie van de virtuele machine. Alleen van toepassing op besturingssysteemschijven. Toegestane waarden zijn V1 en V2.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Location

Resourcelocatie

Type:	String
Position:	3
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-MaximumMemory

Het maximum van het aanbevolen geheugen

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-MaximumVCPU

Het maximum van de aanbevolen CPU-kern

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-MinimumMemory

Het minimum van het aanbevolen geheugen

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-MinimumVCPU

Het minimum van de aanbevolen CPU-kern

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

De naam van de definitie van de galerie-installatiekopieën.

Type:	String
Aliassen:	GalleryImageDefinitionName
Position:	2
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Offer

De naam van de afbeeldingsdefinitieaanbieding van de galerie.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-OsState

De status van het besturingssysteem

Type:	OperatingSystemStateTypes
Geaccepteerde waarden:	Generalized, Specialized
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-OsType

Het type besturingssysteem

Type:	OperatingSystemTypes
Geaccepteerde waarden:	Windows, Linux
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PrivacyStatementUri

De privacyverklaring-URI.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Publisher

De naam van de uitgever van de galerie Image Definition.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PurchasePlanName

De id voor het aankoopplan.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PurchasePlanProduct

De product-id voor het aankoopplan.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PurchasePlanPublisher

De uitgevers-id voor het aankoopplan.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ReleaseNoteUri

De releasenotitie-URI.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceGroupName

De naam van de resourcegroep.

Type:	String
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Sku

De naam van de galerie Image Definition SKU.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Tag

Resourcetags

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String

OperatingSystemStateTypes

OperatingSystemTypes

DateTime

Hashtable

Int32

String[]

Uitvoerwaarden

PSGalleryImage

Delen via