Save-AzureRmVhd
ダウンロードした .vhd イメージをローカルに保存します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Save-AzureRmVhd
[-ResourceGroupName] <String>
[-SourceUri] <Uri>
[-LocalFilePath] <FileInfo>
[[-NumberOfThreads] <Int32>]
[-OverWrite]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Save-AzureRmVhd
[-StorageKey] <String>
[-SourceUri] <Uri>
[-LocalFilePath] <FileInfo>
[[-NumberOfThreads] <Int32>]
[-OverWrite]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Save-AzureRmVhd コマンドレットは、ファイルに格納されている BLOB から .vhd イメージを保存します。 プロセスが使用するダウンローダー スレッドの数と、既に存在するファイルを置き換えるかどうかを指定できます。 このコマンドレットは、コンテンツをそのままダウンロードします。 仮想ハード ディスク (VHD) 形式の変換は適用されません。
例
例 1: イメージをダウンロードする
PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -ResourceGroupName "rgname"
このコマンドは.vhd ファイルをダウンロードし、ローカル パス C:\vhd\Win7Image.vhd に格納します。
例 2: イメージをダウンロードしてローカル ファイルを上書きする
PS C:\> Save-AzureRmVhd -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: 指定した数のスレッドを使用してイメージをダウンロードする
PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfThreads 32 -ResourceGroupName "rgname"
このコマンドは、.vhd ファイルをダウンロードし、ローカル パスに格納します。 このコマンドでは、NumberOfThreads パラメーターの値として 32 を指定します。 そのため、このコマンドレットは、このアクションに 32 個のスレッドを使用します。
例 4: イメージをダウンロードし、ストレージ キーを指定する
PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -StorageKey "zNvcH0r5vAGmC5AbwEtpcyWCMyBd3eMDbdaa4ua6kwxq6vTZH3Y+sw==" -ResourceGroupName "rgname"
このコマンドは、.vhd ファイルをダウンロードし、ストレージ キーを指定します。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行し、進行状況を追跡するジョブを返します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | 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 |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
ストレージ アカウントのリソース グループの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SourceUri
で BLOB Azure
の URI (Uniform Resource Identifier) を指定します。
型: | Uri |
Aliases: | src, Source |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StorageKey
BLOB ストレージ アカウントのストレージ キーを指定します。 キーを指定しない場合、このコマンドレットは、Azure の SourceUri でアカウントのストレージ キーの特定を試みます。
型: | String |
Aliases: | sk |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |