New-AzGalleryImageDefinition

Membuat definisi gambar galeri.

Sintaks

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>]

Deskripsi

Membuat definisi gambar galeri.

Contoh

Contoh 1: Membuat definisi gambar untuk gambar linux khusus

$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

Membuat definisi gambar galeri untuk berisi versi gambar untuk gambar linux khusus.

Contoh 2: Membuat definisi gambar untuk gambar linux umum

$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

Membuat definisi gambar galeri untuk berisi versi gambar untuk gambar linux umum.

Contoh 3: Membuat definisi gambar untuk gambar windows khusus

$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

Membuat definisi gambar galeri untuk berisi versi gambar untuk gambar windows khusus.

Contoh 4: Buat definisi gambar untuk gambar windows umum dan atur fitur.

$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

Membuat definisi gambar galeri untuk berisi versi gambar untuk gambar windows umum.

Contoh 5: Membuat definisi gambar dengan informasi paket

$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

Membuat definisi gambar galeri untuk gambar umum linux dan menentukan nama paket, produk, dan penerbit. Hanya versi gambar yang cocok dengan informasi paket yang dapat ditambahkan ke definisi ini.

Contoh 6: Membuat definisi gambar dan menunjukkan tanggal akhir masa pakai

$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

Contoh ini memiliki tanggal akhir masa pakai untuk definisi gambar yang diatur ke 2 Agustus 2024 pada mignight UTC. Tanggal akhir masa pakai dapat ditentukan untuk definisi gambar dan versi gambar. Definisi gambar masih dapat digunakan setelah tanggal akhir masa pakai.

Contoh 7: Membuat definisi gambar dan merekomendasikan CPU dan memori minimum dan maksimum (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

Membuat definisi gambar galeri dan merekomendasikan rentang minimum dan maksimum untuk CPU dan memori yang didukung versi gambar dalam definisi gambar ini. Versi gambar masih dapat digunakan untuk membuat komputer virtual dengan pengaturan memori dan vCPU di luar rentang yang direkomendasikan.

Contoh 8: Membuat definisi gambar dan menunjukkan jenis disk OS mana yang tidak direkomendasikan untuk gambar

$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

Membuat definisi gambar galeri dan menunjukkan jenis disk OS mana yang mungkin tidak kompatibel dengan versi gambar dalam definisi gambar ini. Versi gambar masih dapat digunakan untuk membuat komputer virtual dengan disk OS yang merupakan salah satu jenis disk yang tidak diizinkan.

Contoh 9: Membuat definisi gambar dan menyediakan URI EULA, pernyataan privasi, dan catatan rilis

$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

Membuat definisi gambar galeri untuk gambar umum linux dan menentukan string atau jalur ke perjanjian EULA, pernyataan privasi, dan catatan rilis yang terkait dengan semua versi gambar dalam definisi gambar.

Parameter

-Architecture

Arsitektur CPU didukung oleh disk OS. Nilai yang mungkin adalah "X64" dan "Arm64".

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

Jalankan cmdlet di latar belakang

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

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

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

Deskripsi sumber daya Definisi gambar galeri.

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

Jenis disk yang tidak diizinkan.

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

Tanggal akhir masa pakai definisi gambar galeri

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

Perjanjian Eula untuk galeri Definisi Gambar.

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

Daftar fitur gambar galeri.

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

Nama galeri.

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

Generasi hypervisor Komputer Virtual. Hanya berlaku untuk disk OS. Nilai yang diizinkan adalah V1 dan V2.

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

Lokasi sumber daya

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

Maksimum memori yang disarankan

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

Maksimum inti CPU yang direkomendasikan

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

Minimum memori yang disarankan

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

Minimum inti CPU yang direkomendasikan

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

Nama definisi gambar galeri.

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

Nama galeri penawaran Definisi Gambar.

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

Status OS

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

Jenis OS

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

Pernyataan privasi uri.

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

Nama galeri penerbit Definisi Gambar.

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

ID untuk paket pembelian.

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

ID produk untuk paket pembelian.

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

ID penerbit untuk paket pembelian.

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

Catatan rilis uri.

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

Nama grup sumber daya.

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

Nama galeri SKU Definisi Gambar.

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

Tag sumber daya

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

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

String

OperatingSystemStateTypes

OperatingSystemTypes

DateTime

Hashtable

Int32

String[]

Output

PSGalleryImage