Add-AzVhd
オンプレミスのマシンから Azure (マネージド ディスクまたは BLOB) に仮想ハード ディスクをアップロードします。
構文
DefaultParameterSet (既定)
Add-AzVhd
[-ResourceGroupName] <String>
[-Destination] <Uri>
[-LocalFilePath] <FileInfo>
[[-NumberOfUploaderThreads] <Int32>]
[[-BaseImageUriToPatch] <Uri>]
[-OverWrite]
[-SkipResizing]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
DirectUploadToManagedDiskSet
Add-AzVhd
[-ResourceGroupName] <String>
[-LocalFilePath] <FileInfo>
[-Location] <String>
[[-NumberOfUploaderThreads] <Int32>]
-DiskName <String>
[-DiskSku <String>]
[-DiskZone <String[]>]
[-DiskHyperVGeneration <String>]
[-DiskOsType <OperatingSystemTypes>]
[-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
バックグラウンドでコマンドレットを実行し、進行状況を追跡するジョブを返します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BaseImageUriToPatch
Azure Blob Storage のベース イメージ BLOB への URI を指定します。
SAS は、このパラメーターの値として指定できます。
パラメーターのプロパティ
| 型: | Uri
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | bs |
パラメーター セット
DefaultParameterSet
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DataAccessAuthMode
ディスクまたはスナップショットにエクスポートまたはアップロードするときの追加の認証要件。 使用可能なオプションは、"AzureActiveDirectory" と "None" です。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
DirectUploadToManagedDiskSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Destination
Blob Storage 内の BLOB の URI を指定します。
パラメーターは SAS URI をサポートしますが、パッチ適用シナリオの宛先を SAS URI にすることはできません。
パラメーターのプロパティ
| 型: | Uri
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | dst |
パラメーター セット
DefaultParameterSet
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DiskHyperVGeneration
仮想マシンのハイパーバイザー生成。 OS ディスクにのみ適用されます。 使用可能な値は、'V1'、'V2' です。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | HyperVGeneration |
パラメーター セット
DirectUploadToManagedDiskSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DiskName
新しいマネージド ディスクの名前
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
DirectUploadToManagedDiskSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DiskOsType
マネージド ディスクのオペレーティング システムの種類。 使用可能な値は、'Windows'、'Linux' です。
パラメーターのプロパティ
| 型: | OperatingSystemTypes
|
| 規定値: | None |
| 指定可能な値: | Windows, Linux |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | OsType |
パラメーター セット
DirectUploadToManagedDiskSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DiskSku
マネージド ディスクの SKU。 オプション: Standard_LRS、Premium_LRS、StandardSSD_LRS、UltraSSD_LRS
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
DirectUploadToManagedDiskSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DiskZone
ディスクの論理ゾーンの一覧。
パラメーターのプロパティ
| 型: | String[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ゾーン |
パラメーター セット
DirectUploadToManagedDiskSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-LocalFilePath
ローカル .vhd ファイルのパスを指定します。
パラメーターのプロパティ
| 型: | FileInfo
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | lf |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Location
新しいマネージド ディスクの場所
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
DirectUploadToManagedDiskSet
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-NumberOfUploaderThreads
.vhd ファイルをアップロードするときに使用するアップローダー スレッドの数を指定します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-OverWrite
指定した宛先 URI の既存の BLOB が存在する場合、このコマンドレットによって上書きされることを示します。
パラメーターのプロパティ
パラメーター セット
DefaultParameterSet
| 配置: | 5 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ResourceGroupName
仮想マシンのリソース グループの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SkipResizing
VHD ファイルのサイズ変更をスキップします。
サイズがずれている VHD ファイル (N * Mib + 512 バイトではない) を BLOB にアップロードする必要があるユーザーは、このスイッチ パラメーターを使用できます。
パラメーターのプロパティ
パラメーター セット
DefaultParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力