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 |