フィードバック

New-AzGalleryImageDefinition

  • リファレンス
モジュール:
Az.Compute

ギャラリー イメージ定義を作成します。

構文

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

説明

ギャラリー イメージ定義を作成します。

例

例 1: 特殊化された Linux イメージのイメージ定義を作成する

$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

特殊化された Linux イメージのイメージ バージョンを含むギャラリー イメージ定義を作成します。

例 2: 一般化された Linux イメージのイメージ定義を作成する

$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

一般化された Linux イメージのイメージ バージョンを含むギャラリー イメージ定義を作成します。

例 3: 特殊化された Windows イメージのイメージ定義を作成する

$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

特殊化された Windows イメージのイメージ バージョンを含むギャラリー イメージ定義を作成します。

例 4: 一般化された Windows イメージのイメージ定義を作成し、機能を設定します。

$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

一般化された Windows イメージのイメージ バージョンを含むギャラリー イメージ定義を作成します。

例 5: プラン情報を使用してイメージ定義を作成する

$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 の一般化されたイメージのギャラリー イメージ定義を作成し、プラン名、製品、および発行元を定義します。 この定義には、プラン情報に一致するイメージ バージョンのみを追加できます。

例 6: イメージ定義を作成し、有効期限を示す

$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

この例では、イメージ定義の有効期限が 2024 年 8 月 2 日 (UTC) に設定されています。 有効期間の終了日は、イメージ定義とイメージ バージョンに指定できます。 イメージ定義は、有効期間の終了日より後でも使用できます。

例 7: イメージ定義を作成し、最小および最大 CPU とメモリ (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

ギャラリー イメージ定義を作成し、このイメージ定義のイメージ バージョンでサポートされる CPU とメモリの最小範囲と最大範囲を推奨します。 イメージ バージョンは、推奨範囲外のメモリと vCPU 設定を持つ仮想マシンを作成するために引き続き使用できます。

例 8: イメージ定義を作成し、イメージに推奨されない OS ディスクの種類を指定する

$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

ギャラリー イメージ定義を作成し、このイメージ定義内のイメージ バージョンと互換性がない OS ディスクの種類を示します。 イメージ バージョンは、許可されていないディスクの種類の 1 つである OS ディスクを使用して仮想マシンを作成するために引き続き使用できます。

例 9: イメージ定義を作成し、EULA、プライバシーに関する声明の URI、リリース ノート URI を指定する

$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 の一般化されたイメージのギャラリー イメージ定義を作成し、イメージ定義内のすべてのイメージ バージョンに関連付けられている EULA 契約、プライバシーに関する声明、リリース ノートの文字列またはパスを指定します。

パラメーター

-Architecture

OS ディスクでサポートされる CPU アーキテクチャ。 指定できる値は、"X64" と "Arm64" です。

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

バックグラウンドでコマンドレットを実行する

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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

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

ギャラリー イメージ定義リソースの説明。

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

許可されていないディスクの種類。

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

ギャラリーイメージ定義の有効期間の終了日

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

ギャラリーイメージ定義の Eula 契約。

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

ギャラリー イメージ機能の一覧。

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

ギャラリーの名前。

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

仮想マシンのハイパーバイザー生成。 OS ディスクにのみ適用されます。 使用できる値は V1 と V2 です。

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

リソースの場所

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

推奨されるメモリの最大数

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

推奨される CPU コアの最大値

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

推奨されるメモリの最小値

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

推奨される CPU コアの最小値

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

ギャラリー イメージ定義の名前。

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

ギャラリーイメージ定義オファーの名前。

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

OS の状態

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

OS の種類

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

プライバシーに関する声明の URI。

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

ギャラリーイメージ定義パブリッシャーの名前。

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

購入プランの ID。

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

購入プランの製品 ID。

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

購入プランの発行元 ID。

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

リリース ノートの URI。

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

リソース グループの名前。

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

ギャラリーイメージ定義 SKU の名前。

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

リソース タグ

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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

String

OperatingSystemStateTypes

OperatingSystemTypes

DateTime

Hashtable

Int32

String[]

出力

PSGalleryImage