Add-AzureVhd

オンプレミスコンピューターから Azure のクラウド ストレージ アカウント内の BLOB に VHD ファイルをアップロードします。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される PowerShell モジュールです。

構文

Add-AzureVhd
   [-Destination] <Uri>
   [-LocalFilePath] <FileInfo>
   [[-NumberOfUploaderThreads] <Int32>]
   [[-BaseImageUriToPatch] <Uri>]
   [-OverWrite]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

説明

Add-AzureVhd コマンドレットは、オンプレミスの仮想ハード ディスク (VHD) イメージを固定 .vhd イメージとして BLOB ストレージ アカウントにアップロードします。 これには、使用するアップローダー スレッドの数の指定や、指定した宛先 URI に既に存在する BLOB の上書きなど、アップロード プロセスを構成するためのパラメーターがあります。 オンプレミス VHD イメージの場合は、既にアップロードされている基本イメージをアップロードしなくても差分ディスク イメージをアップロードできるように、修正プログラムの適用シナリオもサポートされています。 Shared Access Signature (SAS) URI もサポートされています。

例 1: VHD ファイルを追加する

PS C:\> Add-AzureVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd"

このコマンドは、.vhd ファイルをストレージ アカウントに追加します。

例 2: VHD ファイルを追加し、コピー先を上書きする

PS C:\> Add-AzureVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite

このコマンドは、.vhd ファイルをストレージ アカウントに追加します。

例 3: VHD ファイルを追加し、スレッドの数を指定する

PS C:\> Add-AzureVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfThreads 32

このコマンドは、ストレージ アカウントに .vhd ファイルを追加し、ファイルのアップロードに使用するスレッドの数を指定します。

例 4: VHD ファイルを追加し、SAS URI を指定する

PS C:\> Add-AzureVhd -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=<SAS Token>" -LocalFilePath "C:\vhd\win7baseimage.vhd"

このコマンドは、ストレージ アカウントに .vhd ファイルを追加し、SAS URI を指定します。

パラメーター

-BaseImageUriToPatch

Azure Blob Storage のベース イメージ BLOB への URI を指定します。 URI 入力の SAS もサポートされています。

型:Uri
Aliases:bs
配置:4
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Destination

Microsoft Azure Blob Storage 内の BLOB の URI を指定します。 URI 入力の SAS がサポートされています。 ただし、パッチ適用のシナリオでは、宛先を SAS URI にすることはできません。

型:Uri
Aliases:dst
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • [中断]
型:ActionPreference
Aliases:infa
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InformationVariable

情報変数を指定します。

型:String
Aliases:iv
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LocalFilePath

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

型:FileInfo
Aliases:lf
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-NumberOfUploaderThreads

アップロードに使用するスレッドの数を指定します。

型:Int32
Aliases:th
配置:3
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-OverWrite

このコマンドレットが存在する場合は、指定した宛先 URI の既存の BLOB を削除することを指定します。

型:SwitchParameter
Aliases:o
配置:5
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False