Add-AzureRMVhd
Azure のクラウド ストレージ アカウントの BLOB に、オンプレミスの仮想マシンから仮想ハード ディスクをアップロードします。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Add-AzureRMVhd
[[-ResourceGroupName] <String>]
[-Destination] <Uri>
[-LocalFilePath] <FileInfo>
[[-NumberOfUploaderThreads] <Int32>]
[[-BaseImageUriToPatch] <Uri>]
[-OverWrite]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Add-AzureRmVhd コマンドレットは、オンプレミスの仮想ハード ディスクを .vhd ファイル形式で、固定仮想ハード ディスクとして BLOB ストレージ アカウントにアップロードします。 指定した宛先 URI 内の既存の BLOB を使用または上書きするアップローダー スレッドの数を構成できます。 また、修正プログラムが適用されたバージョンのオンプレミスの .vhd ファイルをアップロードする機能もサポートされています。 ベース仮想ハード ディスクが既にアップロードされている場合は、基本イメージを親として使用する差分ディスクをアップロードできます。 Shared Access Signature (SAS) URI もサポートされています。
例
例 1: VHD ファイルを追加する
PS C:\> Add-AzureRmVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd"
このコマンドは、.vhd ファイルをストレージ アカウントに追加します。
例 2: VHD ファイルを追加し、コピー先を上書きする
PS C:\> Add-AzureRmVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite
このコマンドは、.vhd ファイルをストレージ アカウントに追加します。 このコマンドは、既存のファイルを上書きします。
例 3: VHD ファイルを追加し、スレッドの数を指定する
PS C:\> Add-AzureRmVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfUploaderThreads 32
このコマンドは、.vhd ファイルをストレージ アカウントに追加します。 このコマンドは、ファイルのアップロードに使用するスレッドの数を指定します。
例 4: VHD ファイルを追加し、SAS URI を指定する
PS C:\> Add-AzureRmVhd -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 を指定します。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行し、進行状況を追跡するジョブを返します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-BaseImageUriToPatch
Azure Blob Storage のベース イメージ BLOB への URI を指定します。 SAS は、このパラメーターの値として指定できます。
型: | Uri |
Aliases: | bs |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Destination
Blob Storage 内の BLOB の URI を指定します。 パラメーターは SAS URI をサポートしますが、パッチ適用シナリオの宛先を SAS URI にすることはできません。
型: | Uri |
Aliases: | dst |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-LocalFilePath
ローカル .vhd ファイルのパスを指定します。
型: | FileInfo |
Aliases: | lf |
配置: | 2 |
規定値: | 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 |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]