New-AzGalleryImageDefinition

Referens

Modul:: Az.Compute

Skapa en galleribilddefinition.

Anteckning

Det här är den tidigare versionen av vår dokumentation. Se den senaste versionen för uppdaterad information.

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

Skapa en galleribilddefinition.

Exempel

Exempel 1: Skapa en avbildningsdefinition för specialiserade Linux-avbildningar

$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

Skapar en galleribilddefinition som ska innehålla avbildningsversioner för specialiserade Linux-avbildningar.

Exempel 2: Skapa en avbildningsdefinition för generaliserade Linux-avbildningar

$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

Skapar en galleribilddefinition som ska innehålla avbildningsversioner för generaliserade Linux-avbildningar.

Exempel 3: Skapa en avbildningsdefinition för specialiserade Windows-avbildningar

$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

Skapar en galleribilddefinition som ska innehålla avbildningsversioner för specialiserade Windows-avbildningar.

Exempel 4: Skapa en avbildningsdefinition för generaliserade Windows-avbildningar och ange funktioner.

$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

Skapar en galleribilddefinition som ska innehålla avbildningsversioner för generaliserade Windows-avbildningar.

Exempel 5: Skapa en avbildningsdefinition med planinformation

$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

Skapar en galleribilddefinition för generaliserade Linux-avbildningar och definierar planens namn, produkt och utgivare. Endast avbildningsversioner som matchar planinformationen kan läggas till i den här definitionen.

Exempel 6: Skapa en bilddefinition och ange slutdatum

$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

I det här exemplet anges slutdatumet för bilddefinitioner till 2 augusti 2024 vid mignight UTC. Slutdatum kan anges för bilddefinitioner och bildversioner. Bilddefinitioner kan fortfarande användas efter slutdatumen.

Exempel 7: Skapa en avbildningsdefinition och rekommendera lägsta och högsta CPU och minne (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

Skapar en galleribilddefinition och rekommenderar det lägsta och högsta intervallet för processorn och minnet som avbildningsversionerna i den här avbildningsdefinitionen stöder. Avbildningsversioner kan fortfarande användas för att skapa virtuella datorer med minne och vCPU-inställningar utanför de rekommenderade intervallen.

Exempel 8: Skapa en avbildningsdefinition och ange vilka os-disktyper som inte rekommenderas för avbildningen

$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

Skapar en galleriavbildningsdefinition och anger vilka os-disktyper som kanske inte är kompatibla med avbildningsversioner i den här avbildningsdefinitionen. Avbildningsversioner kan fortfarande användas för att skapa virtuella datorer med en OS-disk som är en av de otillåtna disktyperna.

Exempel 9: Skapa en avbildningsdefinition och ange LICENSAVTAL, URI för sekretesspolicy och URI för viktig information

$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

Skapar en galleribilddefinition för generaliserade Linux-avbildningar och anger antingen strängen eller sökvägen till ett EULA-avtal, sekretesspolicy och viktig information som är kopplad till alla avbildningsversioner i avbildningsdefinitionen.

Parametrar

-AsJob

Kör cmdleten i bakgrunden

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-DefaultProfile

Autentiseringsuppgifterna, kontot, klientorganisationen och prenumerationen som används för kommunikation med Azure.

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

-Description

Beskrivningen av galleribilddefinitionsresursen.

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

-DisallowedDiskType

De otillåtna disktyperna.

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

-EndOfLifeDate

Slutdatumet för galleriets bilddefinition

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

-Eula

Eula-avtalet för galleriet Image Definition.

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

-Feature

En lista över galleribildfunktioner.

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

-GalleryName

Galleriets namn.

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

-HyperVGeneration

Hypervisor-genereringen av den virtuella datorn. Gäller endast os-diskar. Tillåtna värden är V1 och V2.

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

-Location

Resursplats

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

-MaximumMemory

Maximalt av det rekommenderade minnet

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

-MaximumVCPU

Maximalt antal processorkärnor som rekommenderas

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

-MinimumMemory

Det minsta rekommenderade minnet

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

-MinimumVCPU

Det minsta av den rekommenderade CPU-kärnan

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

-Name

Namnet på galleribilddefinitionen.

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

-Offer

Namnet på galleriets erbjudande för bilddefinition.

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

-OsState

Operativsystemets tillstånd

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

-OsType

Typ av operativsystem

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

-PrivacyStatementUri

Sekretesspolicyns URI.

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

-Publisher

Namnet på galleriets bilddefinitionsutgivare.

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

-PurchasePlanName

ID:t för inköpsplanen.

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

-PurchasePlanProduct

Produkt-ID för inköpsplanen.

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

-PurchasePlanPublisher

Utgivar-ID för inköpsplanen.

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

-ReleaseNoteUri

Versionsanteckningens URI.

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

-ResourceGroupName

Namnet på resursgruppen.

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

-Sku

Namnet på galleriets SKU för bilddefinition.

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

-Tag

Resurstaggar

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

String

OperatingSystemStateTypes

OperatingSystemTypes

DateTime

Hashtable

Int32

String[]

Utdata

PSGalleryImage