Save-AzVhd
ダウンロードした .vhd イメージをローカルに保存します。
構文
ResourceGroupParameterSetName
Save-AzVhd
[-ResourceGroupName] <String>
[-SourceUri] <Uri>
[-LocalFilePath] <FileInfo>
[[-NumberOfThreads] <Int32>]
[-OverWrite]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
StorageKeyParameterSetName
Save-AzVhd
[-StorageKey] <String>
[-SourceUri] <Uri>
[-LocalFilePath] <FileInfo>
[[-NumberOfThreads] <Int32>]
[-OverWrite]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Save-AzVhd コマンドレットは、ファイルに格納されている BLOB から .vhd イメージを保存します。
プロセスが使用するダウンローダー スレッドの数と、既に存在するファイルを置き換えるかどうかを指定できます。
このコマンドレットは、コンテンツをそのままダウンロードします。
仮想ハード ディスク (VHD) 形式の変換は適用されません。
例
例 1: イメージをダウンロードする
Save-AzVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -ResourceGroupName "rgname"
このコマンドは.vhd ファイルをダウンロードし、ローカル パス C:\vhd\Win7Image.vhd に格納します。
例 2: イメージをダウンロードしてローカル ファイルを上書きする
Save-AzVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite -ResourceGroupName "rgname"
このコマンドは、.vhd ファイルをダウンロードし、ローカル パスに格納します。
このコマンドには、 Overwrite パラメーターが含まれています。
したがって、C:\vhd\Win7Image.vhd が既に存在する場合は、このコマンドによって置き換えられます。
例 3: 指定した数のスレッドを使用してイメージをダウンロードする
Save-AzVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfThreads 32 -ResourceGroupName "rgname"
このコマンドは、.vhd ファイルをダウンロードし、ローカル パスに格納します。
このコマンドでは、 NumberOfThreads パラメーターの値として 32 を指定します。
そのため、このコマンドレットは、このアクションに 32 個のスレッドを使用します。
例 4: イメージをダウンロードし、ストレージ キーを指定する
Save-AzVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -StorageKey "zNvcH0r5vAGmC5AbwEtpcyWCMyBd3eMDbdaa4ua6kwxq6vTZH3Y+sw=="
このコマンドは、.vhd ファイルをダウンロードし、ストレージ キーを指定します。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行し、進行状況を追跡するジョブを返します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LocalFilePath
保存したイメージのローカル ファイル パスを指定します。
パラメーターのプロパティ
| 型: | FileInfo
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | lf |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NumberOfThreads
このコマンドレットがダウンロード時に使用するダウンロード スレッドの数を指定します。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 番目 |
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OverWrite
このコマンドレットが存在する場合は、 LocalFilePath ファイルで指定されたファイルを置き換えることを示します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResourceGroupName
ストレージ アカウントのリソース グループの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ResourceGroupParameterSetName
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SourceUri
Azure内の BLOB の URI (Uniform Resource Identifier) を指定します。
パラメーターのプロパティ
| 型: | Uri
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | src, 情報源 |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-StorageKey
BLOB ストレージ アカウントのストレージ キーを指定します。
キーを指定しない場合、このコマンドレットは、Azure の SourceUri でアカウントのストレージ キーの特定を試みます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | sk |
パラメーター セット
StorageKeyParameterSetName
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力