New-AzGalleryImageDefinition

Başvuru

Modül:: Az.Compute

Galeri görüntüsü tanımı oluşturun.

Sözdizimi

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

Galeri görüntüsü tanımı oluşturun. Galeri görüntüsü tanımı, açıkça ayarlanmamışsa -HyperVGeneration -Feature @{Name: SecurityType} varsayılan olarak 'HyperVGeneration: V2' ve 'SecurityType: TrustedLaunchSupported' olarak ayarlanır. Bu varsayılan ayarı geri çevirmek için SecurityType'ı 'Yok' olarak ayarlayın (Bkz. Örnek 10).

Örnekler

Örnek 1: Özelleştirilmiş Linux görüntüleri için görüntü tanımı oluşturma

$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

Özelleştirilmiş Linux görüntüleri için görüntü sürümlerini içerecek bir galeri görüntüsü tanımı oluşturur. Bu, Galeri Görüntüsünü varsayılan olarak HyperVGeneration V2 ve Güvenilen Başlatma olarak -HyperVGeneration ayarlar ve -Feature SecurityType açıkça ayarlanmaz.

Örnek 2: Genelleştirilmiş Linux görüntüleri için görüntü tanımı oluşturma

$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

Genelleştirilmiş Linux görüntüleri için görüntü sürümlerini içerecek bir galeri görüntüsü tanımı oluşturur.

Örnek 3: Özelleştirilmiş windows görüntüleri için görüntü tanımı oluşturma

$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

Özelleştirilmiş windows görüntüleri için görüntü sürümlerini içerecek bir galeri görüntüsü tanımı oluşturur.

Örnek 4: Genelleştirilmiş windows görüntüleri ve küme özellikleri için bir görüntü tanımı oluşturun.

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

Genelleştirilmiş windows görüntüleri için görüntü sürümlerini içerecek bir galeri görüntüsü tanımı oluşturur.

Örnek 5: Plan bilgileriyle görüntü tanımı oluşturma

$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

Linux genelleştirilmiş görüntüleri için bir galeri görüntüsü tanımı oluşturur ve plan adını, ürünü ve yayımcıyı tanımlar. Bu tanıma yalnızca plan bilgileriyle eşleşen görüntü sürümleri eklenebilir.

Örnek 6: Görüntü tanımı oluşturma ve kullanım süresi sonu tarihini belirtme

$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

Bu örnekte, mignight UTC itibarıyla 2 Ağustos 2024 olarak ayarlanmış görüntü tanımları için kullanım süresi sonu tarihi verilmiştir. Görüntü tanımları ve görüntü sürümleri için yaşam sonu tarihleri belirtilebilir. Resim tanımları, kullanım süresi sonu tarihlerinden sonra da kullanılabilir.

Örnek 7: Görüntü tanımı oluşturma ve en düşük ve en yüksek CPU ve bellek (GB) önerme

$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

Bir galeri görüntüsü tanımı oluşturur ve bu görüntü tanımındaki görüntü sürümlerinin desteklediği CPU ve bellek için en düşük ve en yüksek aralıkları önerir. Görüntü sürümleri, önerilen aralıkların dışında bellek ve vCPU ayarlarına sahip sanal makineler oluşturmak için kullanılabilir.

Örnek 8: Görüntü tanımı oluşturma ve görüntü için hangi işletim sistemi disk türlerinin önerilmediğini belirtme

$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

Bir galeri görüntüsü tanımı oluşturur ve hangi işletim sistemi disk türlerinin bu görüntü tanımı içindeki görüntü sürümleriyle uyumlu olmayabileceğini gösterir. Görüntü sürümleri, izin verilmeyen disk türlerinden biri olan bir işletim sistemi diskine sahip sanal makineler oluşturmak için kullanılabilir.

Örnek 9: Görüntü tanımı oluşturma ve EULA, gizlilik bildirimi URI'sini ve sürüm notları URI'sini sağlama

$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

Linux genelleştirilmiş görüntüleri için bir galeri görüntüsü tanımı oluşturur ve görüntü tanımındaki tüm görüntü sürümlerine bağlı bir EULA sözleşmesinin, gizlilik bildiriminin ve sürüm notlarının dizesini veya yolunu belirtir.

Örnek 10: Standart SecurityType özelliğiyle galeri görüntüsü tanımı oluşturma

$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

SecurityType özelliğinin değeri olarak 'Hiçbiri' sağlayarak standart güvenlik türü özelliğiyle bir galeri görüntüsü tanımı oluşturun.

Parametreler

-Architecture

İşletim sistemi diski tarafından desteklenen CPU mimarisi. Olası değerler "X64" ve "Arm64" şeklindedir.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-AsJob

Cmdlet'i arka planda çalıştırma

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:	IAzureContextContainer
Diğer adlar:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Description

Galeri görüntüsü Tanım kaynağının açıklaması.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-DisallowedDiskType

İzin verilmeyen disk türleri.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-EndOfLifeDate

Galerinin kullanım ömrü sonu tarihi Resim Tanımı

Tür:	DateTime
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Eula

Resim Tanımı galerisi için Eula sözleşmesi.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Feature

Galeri görüntüsü özelliklerinin listesi. SecurityType için kabul edilebilir girişler şunlardır: None, TrustedlaunchSupported, Trustedlaunch, ConfidentialVM, ConfidentialVMSupported, TrustedandConfidentialVMSupported

Tür:	GalleryImageFeature[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-GalleryName

Galerinin adı.

Tür:	String
Position:	1
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-HyperVGeneration

Sanal Makinenin hiper yönetici oluşturması. Yalnızca işletim sistemi diskleri için geçerlidir. İzin verilen değerler V1 ve V2'dir.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Location

Kaynak konumu

Tür:	String
Position:	3
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-MaximumMemory

Önerilen bellek üst sınırı

Tür:	Int32
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-MaximumVCPU

Önerilen CPU çekirdeğinin üst sınırı

Tür:	Int32
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-MinimumMemory

Önerilen belleğin en azı

Tür:	Int32
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-MinimumVCPU

Önerilen CPU çekirdeğinin en azı

Tür:	Int32
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Name

Galeri görüntüsü tanımının adı.

Tür:	String
Diğer adlar:	GalleryImageDefinitionName
Position:	2
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Offer

Galeri Görüntü Tanımı teklifinin adı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-OsState

İşletim sisteminin durumu

Tür:	OperatingSystemStateTypes
Kabul edilen değerler:	Generalized, Specialized
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-OsType

İşletim sistemi türü

Tür:	OperatingSystemTypes
Kabul edilen değerler:	Windows, Linux
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-PrivacyStatementUri

Gizlilik bildirimi uri'sini seçin.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Publisher

Galeri Görüntü Tanımı yayımcısının adı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-PurchasePlanName

Satın alma planının kimliği.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-PurchasePlanProduct

Satın alma planının ürün kimliği.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-PurchasePlanPublisher

Satın alma planının yayımcı kimliği.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-ReleaseNoteUri

Sürüm notu uri'si.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-ResourceGroupName

Kaynak grubunun adı.

Tür:	String
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Sku

GaleriNin Resim Tanımı SKU'su adı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Tag

Kaynak etiketleri

Tür:	Hashtable
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

String

OperatingSystemStateTypes

OperatingSystemTypes

DateTime

Hashtable

Int32

String[]

Çıkışlar

PSGalleryImage

Aracılığıyla paylaş