Add-AzVhd

リファレンス

モジュール:: Az.Compute

オンプレミスのマシンから Azure (マネージドディスクまたは BLOB) に仮想ハードディスクをアップロードします。

構文

Add-AzVhd
   [-ResourceGroupName] <String>
   [-Destination] <Uri>
   [-LocalFilePath] <FileInfo>
   [[-NumberOfUploaderThreads] <Int32>]
   [[-BaseImageUriToPatch] <Uri>]
   [-OverWrite]
   [-SkipResizing]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzVhd
   [-ResourceGroupName] <String>
   [-LocalFilePath] <FileInfo>
   -DiskName <String>
   [-Location] <String>
   [-DiskSku <String>]
   [-DiskZone <String[]>]
   [-DiskHyperVGeneration <String>]
   [-DiskOsType <OperatingSystemTypes>]
   [[-NumberOfUploaderThreads] <Int32>]
   [-DataAccessAuthMode <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Add-AzVhd コマンドレットは、オンプレミスの仮想ハードディスクをマネージドディスクまたは BLOB ストレージアカウントにアップロードします。

アップロードする仮想ハードディスクは、.vhd ファイルで、サイズ N * Mib + 512 バイトである必要があります。 Hyper-V 機能を使用すると、Add-AzVhd は .vhdx ファイルを .vhd ファイルに変換し、アップロードする前にサイズを変更します。この機能を許可するには、 Hyper-V を有効にする必要があります。 Linux マシンを使用している場合、またはこの機能を使用しないことを選択した場合は、 VHD ファイルのサイズを手動で変更する必要があります。さらに、 Add-AzVhd は、アップロード中に動的にサイズが設定された VHD ファイルを固定サイズに変換します。すべてのプロセスに従うために使用 -Verbose します。

既定のパラメーターセット (BLOB へのアップロード) では、オンプレミスの .vhd ファイルの修正プログラムが適用されたバージョンをアップロードする機能もサポートされています。ベース仮想ハードディスクが既にアップロードされている場合は、基本イメージを親として使用する差分ディスクをアップロードできます。共有アクセス署名 (SAS) URI もサポートされています。

マネージドディスクへの直接アップロードパラメーターセットの場合、パラメーター: ResourceGroupName、DiskName、Location、DiskSku、Zone が新しいディスクの作成に使用され、仮想ハードディスクがそれにアップロードされます。

Add-AzVhdを使用してマネージドディスクに直接アップロードする方法の詳細について説明します。

50 GB を超える VHD ファイルの場合は、 AzCopy を使用してアップロードを高速化することをお勧めします。

例

例 1: BLOB に VHD ファイルを追加する

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd"

このコマンドは、.vhd ファイルをストレージアカウントに追加します。

例 2: BLOB に VHD ファイルを追加し、コピー先を上書きする

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite

このコマンドは、.vhd ファイルをストレージアカウントに追加します。コマンドは既存のファイルを上書きします。

例 3: スレッド数が指定された BLOB に VHD ファイルを追加する

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfUploaderThreads 32

このコマンドは、.vhd ファイルをストレージアカウントに追加します。このコマンドは、ファイルのアップロードに使用するスレッドの数を指定します。

例 4: BLOB に VHD ファイルを追加し、SAS URI を指定する

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd?st=2013-01 -09T22%3A15%3A49Z&se=2013-01-09T23%3A10%3A49Z&sr=b&sp=w&sig=13T9Ow%2FRJAMmhfO%2FaP3HhKKJ6AY093SmveO SIV4%2FR7w%3D" -LocalFilePath "C:\vhd\win7baseimage.vhd"

このコマンドは、ストレージアカウントに .vhd ファイルを追加し、SAS URI を指定します。

例 5: VHD ファイルをマネージドディスクに直接追加する。

Add-AzVhd -LocalFilePath C:\data.vhd -ResourceGroupName rgname -Location eastus -DiskName newDisk

このコマンドは、指定された ResourceGroupName、Location、DiskName を使用してマネージドディスクを作成します。VHD ファイルをアップロードします。

例 6: 構成済みのディスクに VHD ファイルを直接追加します。

Add-AzVhd -LocalFilePath C:\Data.vhdx -ResourceGroupName rgname -Location eastus -DiskName newDisk -Zone 1 -DiskSku Premium_LRS

このコマンドは、まず Hyper-V を使用して vhdx ファイルを vhd ファイルに変換しようと試みます。 Hyper-V が見つからない場合は、vhd ファイルの使用を求めるエラーが返されます。変換が成功すると、指定されたパラメーターを持つマネージドディスクが作成され、vhd ファイルがアップロードされます。

パラメーター

-AsJob

バックグラウンドでコマンドレットを実行し、ジョブを返して進行状況を追跡します。

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

-BaseImageUriToPatch

Azure Blob Storageのベースイメージ BLOB への URI を指定します。 SAS は、このパラメーターの値として指定できます。

Type:	Uri
Aliases:	bs
Position:	4
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DataAccessAuthMode

ディスクまたはスナップショットにエクスポートまたはアップロードするときの追加の認証要件。使用可能なオプションは、"AzureActiveDirectory" と "None" です。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
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

-Destination

Blob Storage 内の BLOB の URI を指定します。パラメーターは SAS URI をサポートしていますが、パッチ適用シナリオの宛先は SAS URI にすることはできません。

Type:	Uri
Aliases:	dst
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskHyperVGeneration

仮想マシンのハイパーバイザーの生成。 OS ディスクにのみ適用されます。可能な値は、'V1'、'V2' です。

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

-DiskName

新しいマネージドディスクの名前

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

-DiskOsType

マネージドディスクのオペレーティングシステムの種類。使用可能な値は、"Windows"、"Linux" です。

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

-DiskSku

マネージドディスクの SKU。オプション: Standard_LRS、Premium_LRS、StandardSSD_LRS、UltraSSD_LRS

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

-DiskZone

ディスクの論理ゾーンの一覧。

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

-LocalFilePath

ローカル .vhd ファイルのパスを指定します。

Type:	FileInfo
Aliases:	lf
Position:	2
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

新しいマネージドディスクの場所

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

-NumberOfUploaderThreads

.vhd ファイルをアップロードするときに使用するアップローダースレッドの数を指定します。

Type:	Nullable<T>[Int32]
Aliases:	th
Position:	3
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OverWrite

指定した宛先 URI 内の既存の BLOB が存在する場合、このコマンドレットによって上書きされることを示します。

Type:	SwitchParameter
Aliases:	o
Position:	5
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

-SkipResizing

VHD ファイルのサイズ変更をスキップします。サイズが正しくない VHD ファイル (N * Mib + 512 バイトではない) を BLOB にアップロードするユーザーは、この switch パラメーターを使用できます。

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

入力

String

Uri

FileInfo

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

SwitchParameter

出力

VhdUploadContext

Save-AzVhd