New-AzImageConfig

構成可能なイメージ オブジェクトを作成します。

構文

New-AzImageConfig
   [[-Location] <String>]
   [-EdgeZone <String>]
   [[-Tag] <Hashtable>]
   [[-SourceVirtualMachineId] <String>]
   [[-OsDisk] <ImageOSDisk>]
   [-HyperVGeneration <String>]
   [-DataDisk <ImageDataDisk[]>]
   [-ZoneResilient]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzImageConfig コマンドレットは、構成可能なイメージ オブジェクトを作成します。

例 1

$imageConfig = New-AzImageConfig -Location 'West US';
$osDiskVhdUri = "https://contoso.blob.core.windows.net/test/os.vhd"
$dataDiskVhdUri1 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$dataDiskVhdUri2 = "https://contoso.blob.core.windows.net/test/data2.vhd"
Set-AzImageOsDisk -Image $imageConfig -OsType 'Windows' -OsState 'Generalized' -BlobUri $osDiskVhdUri;
Add-AzImageDataDisk -Image $imageConfig -Lun 1 -BlobUri $dataDiskVhdUri1;
Add-AzImageDataDisk -Image $imageConfig -Lun 2 -BlobUri $dataDiskVhdUri2;
New-AzImage -Image $imageConfig -ImageName 'ImageName01' -ResourceGroupName 'ResourceGroup01';

最初のコマンドは、イメージ オブジェクトを作成し、$imageConfig変数に格納します。 次の 3 つのコマンドは、os ディスクと 2 つのデータ ディスクのパスを $osDiskVhdUri、$dataDiskVhdUri 1、および $dataDiskVhdUri 2 変数に割り当てます。 この方法は、次のコマンドの読みやすさのみを目的としています。 次の 3 つのコマンドは、それぞれ os ディスクと 2 つのデータ ディスクを、$imageConfigに格納されているイメージに追加します。 各ディスクの URI は、$osDiskVhdUri、$dataDiskVhdUri 1、および $dataDiskVhdUri 2 に格納されます。 最後のコマンドは、リソース グループ 'ResourceGroup01' に 'ImageName01' という名前のイメージを作成します。

パラメーター

-Confirm

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

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

-DataDisk

データ ディスク オブジェクトを指定します。

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

-DefaultProfile

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

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

-EdgeZone

エッジ ゾーン名を設定します。 設定すると、クエリは、メインリージョンではなく、指定したエッジゾーンにルーティングされます。

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

-HyperVGeneration

イメージから作成された仮想マシンの HyperVGeneration の種類を指定します。 使用できる値は V1 と V2 です。

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

-Location

場所を指定します。

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

-OsDisk

オペレーティング システムのディスクを指定します。

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

-SourceVirtualMachineId

ソース仮想マシン ID を指定します。

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

-Tag

ハッシュ テーブルの形式のキーと値のペア。 例: @{key0="value0";key1=$null;key2="value2"}

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

-WhatIf

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

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

-ZoneResilient

ゾーンの回復性を有効にする

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

入力

String

Hashtable

ImageOSDisk

ImageDataDisk[]

出力

PSImage