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
バックグラウンドでコマンドレットを実行し、進行状況を追跡するジョブを返します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BaseImageUriToPatch
Azure Blob Storage のベース イメージ BLOB への URI を指定します。 SAS は、このパラメーターの値として指定できます。
| Type: | Uri |
| Aliases: | bs |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DataAccessAuthMode
ディスクまたはスナップショットにエクスポートまたはアップロードするときの追加の認証要件。 使用可能なオプションは、"AzureActiveDirectory" と "None" です。
| Type: | String |
| 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 |
-Destination
Blob Storage 内の BLOB の URI を指定します。 パラメーターは SAS URI をサポートしますが、パッチ適用シナリオの宛先を SAS URI にすることはできません。
| Type: | Uri |
| Aliases: | dst |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DiskHyperVGeneration
仮想マシンのハイパーバイザー生成。 OS ディスクにのみ適用されます。 値は 'V1'、'V2' です。
| Type: | String |
| Aliases: | HyperVGeneration |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DiskName
新しいマネージド ディスクの名前
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DiskOsType
マネージド ディスクのオペレーティング システムの種類。 使用可能な値は、'Windows'、'Linux' です。
| Type: | OperatingSystemTypes |
| Aliases: | OsType |
| Accepted values: | Windows, Linux |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DiskSku
マネージド ディスクの SKU。 オプション: Standard_LRS、プレミアム_LRS、StandardSSD_LRS、UltraSSD_LRS
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DiskZone
ディスクの論理ゾーンの一覧。
| Type: | String[] |
| Aliases: | Zone |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LocalFilePath
ローカル .vhd ファイルのパスを指定します。
| Type: | FileInfo |
| Aliases: | lf |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
新しいマネージド ディスクの場所
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NumberOfUploaderThreads
.vhd ファイルをアップロードするときに使用するアップローダー スレッドの数を指定します。
| Type: | Nullable<T>[Int32] |
| Aliases: | th |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OverWrite
指定した宛先 URI の既存の BLOB が存在する場合、このコマンドレットによって上書きされることを示します。
| Type: | SwitchParameter |
| Aliases: | o |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
仮想マシンのリソース グループの名前を指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipResizing
VHD ファイルのサイズ変更をスキップします。 サイズがずれている VHD ファイル (N * Mib + 512 バイトではない) を BLOB にアップロードする必要があるユーザーは、このスイッチ パラメーターを使用できます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
出力
関連リンク
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示