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

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

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

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases: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

-LocalFilePath

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

Type:FileInfo
Aliases:lf
Position:2
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:False
Accept pipeline input:True
Accept wildcard characters:False

入力

String

Uri

FileInfo

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

SwitchParameter

出力

VhdUploadContext