Save-AzureVhd

.vhd イメージのダウンロードを有効にします。

Note

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

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

構文

Save-AzureVhd
    [-Source] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [[-StorageKey] <String>]
    [-OverWrite]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

説明

Save-AzureVhd コマンドレットを使用すると、ファイルに格納されている BLOB から .vhd イメージをダウンロードできます。 これには、指定されたファイル パスに既に存在するファイルを使用または上書きするダウンローダー スレッドの数を指定して、ダウンロード プロセスを構成するためのパラメーターがあります。

Save-AzureVhd は VHD 形式の変換を行わず、BLOB をそのままダウンロードします。

例 1: VHD ファイルをダウンロードする

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

このコマンドを実行すると、.vhd ファイルがダウンロードされます。

例 2: VHD ファイルをダウンロードしてローカル ファイルを上書きする

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

このコマンドは、.vhd ファイルをダウンロードし、宛先パス内のすべてのファイルを上書きします。

例 3: VHD ファイルをダウンロードし、スレッドの数を指定する

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

このコマンドは、.vhd ファイルをダウンロードし、スレッドの数を指定します。

例 4: VHD ファイルをダウンロードし、ストレージ キーを指定する

PS C:\> Save-AzureVhd -Source "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -StorageKey "zNvcH0r5vAGmC5AbwEtpcyWCMyBd3eMDbdaa4ua6kwxq6vTZH3Y+sw=="

このコマンドは、.vhd ファイルをダウンロードし、ストレージ キーを指定します。

パラメーター

-InformationAction

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

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

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

-InformationVariable

情報変数を指定します。

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

-LocalFilePath

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

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

-NumberOfThreads

このコマンドレットがダウンロード時に使用するダウンロード スレッドの数を指定します。

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

-OverWrite

このコマンドレットは、LocalFilePath ファイルで指定されたファイルが存在する場合に削除することを指定します。

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

-Profile

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

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

-Source

内の BLOB Azureに対する URI (Uniform Resource Identifier) を指定します。

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

-StorageKey

BLOB ストレージ アカウントのストレージ キーを指定します。 指定されていない場合、Save-AzureVhd は Azure から SourceUriのアカウントのストレージ キーの決定を試みます。

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