New-AzGalleryImageDefinition

Referentie

Module:: Az.Compute

Maak een definitie van een galerie-installatiekopieën.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

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[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Maak een definitie van een galerie-installatiekopieën.

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 galerieinstallatiekopieën om installatiekopieën voor gespecialiseerde Linux-installatiekopieën te bevatten.

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'}
$features = @($IsHibernateSupported,$IsAcceleratedNetworkSupported)
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Windows" -Description $description -Feature $features

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

Voorbeeld 5: Een afbeeldingsdefinitie 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 de einddatum 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.

Voorbeeld 7: Een definitie van een installatiekopieën maken en minimale en maximale CPU en maximaal 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 typen besturingssysteemschijven 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 schijftypen van het besturingssysteem mogelijk niet compatibel zijn met installatiekopieën binnen 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 releaseopmerkingen 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 naar een EULA-overeenkomst, privacyverklaring en releaseopmerkingen op die zijn gekoppeld aan alle versies van de installatiekopie in de definitie van de installatiekopie.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

De beschrijving van de definitieresource van de galerie-installatiekopieën.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DisallowedDiskType

De niet-toegestane schijftypen.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-EndOfLifeDate

De einddatum van de definitie van de galerie-installatiekopieën

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Eula

De Eula-overeenkomst voor de definitie van de galerie-installatiekopieën.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Feature

Een lijst met functies voor galerieafbeeldingen.

Type:	GalleryImageFeature[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-GalleryName

De naam van de galerie.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

Resourcelocatie

Type:	String
Position:	3
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-MaximumMemory

Het maximum van het aanbevolen geheugen

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-MaximumVCPU

Het maximum van de aanbevolen CPU-kern

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-MinimumMemory

Het minimum van het aanbevolen geheugen

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-MinimumVCPU

Het minimum van de aanbevolen CPU-kern

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	GalleryImageDefinitionName
Position:	2
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Offer

De naam van de aanbieding afbeeldingsdefinitie van de galerie.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OsState

De status van het besturingssysteem

Type:	OperatingSystemStateTypes
Accepted values:	Generalized, Specialized
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OsType

Het type besturingssysteem

Type:	OperatingSystemTypes
Accepted values:	Windows, Linux
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PrivacyStatementUri

De privacyverklaring-URI.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Publisher

De naam van de uitgever van de installatiekopieëndefinitie van de galerie.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PurchasePlanName

De id voor het aankoopplan.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PurchasePlanProduct

De product-id voor het aankoopplan.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PurchasePlanPublisher

De uitgever-id voor het aankoopplan.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ReleaseNoteUri

De releasenotitie-URI.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

De naam van de resourcegroep.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Sku

De naam van de galerie Image Definition SKU.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Resourcetags

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

String

OperatingSystemStateTypes

OperatingSystemTypes

DateTime

Hashtable

Int32

String[]

Uitvoerwaarden

PSGalleryImage