Add-AzVhd
オンプレミスのマシンから 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 ファイルをアップロードする機能もサポートされています。
ベース仮想ハード ディスクが既にアップロードされている場合は、基本イメージを親として使用する差分ディスクをアップロードできます。
Shared Access Signature (SAS) URI もサポートされています。
Managed Disk パラメーター セットへの直接アップロードの場合、パラメーター: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
バックグラウンドでコマンドレットを実行し、進行状況を追跡するジョブを返します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-BaseImageUriToPatch
Azure Blob Storage のベース イメージ BLOB への URI を指定します。 SAS は、このパラメーターの値として指定できます。
型: | Uri |
Aliases: | bs |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DataAccessAuthMode
ディスクまたはスナップショットにエクスポートまたはアップロードするときの追加の認証要件。 使用可能なオプションは、"AzureActiveDirectory" と "None" です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Destination
Blob Storage 内の BLOB の URI を指定します。 パラメーターは SAS URI をサポートしますが、パッチ適用シナリオの宛先を SAS URI にすることはできません。
型: | Uri |
Aliases: | dst |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DiskHyperVGeneration
仮想マシンのハイパーバイザー生成。 OS ディスクにのみ適用されます。 値は 'V1'、'V2' です。
型: | String |
Aliases: | HyperVGeneration |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DiskName
新しいマネージド ディスクの名前
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DiskOsType
マネージド ディスクのオペレーティング システムの種類。 使用可能な値は、'Windows'、'Linux' です。
型: | OperatingSystemTypes |
Aliases: | OsType |
指定可能な値: | Windows, Linux |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DiskSku
マネージド ディスクの SKU。 オプション: Standard_LRS、Premium_LRS、StandardSSD_LRS、UltraSSD_LRS
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DiskZone
ディスクの論理ゾーンの一覧。
型: | String[] |
Aliases: | Zone |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-LocalFilePath
ローカル .vhd ファイルのパスを指定します。
型: | FileInfo |
Aliases: | lf |
配置: | 2 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Location
新しいマネージド ディスクの場所
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-NumberOfUploaderThreads
.vhd ファイルをアップロードするときに使用するアップローダー スレッドの数を指定します。
型: | Nullable<T>[Int32] |
Aliases: | th |
配置: | 3 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-OverWrite
指定した宛先 URI の既存の BLOB が存在する場合、このコマンドレットによって上書きされることを示します。
型: | SwitchParameter |
Aliases: | o |
配置: | 5 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
仮想マシンのリソース グループの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SkipResizing
VHD ファイルのサイズ変更をスキップします。 サイズがずれている VHD ファイル (N * Mib + 512 バイトではない) を BLOB にアップロードする必要があるユーザーは、このスイッチ パラメーターを使用できます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]