Share via


Save-AzureVhd

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

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

情報変数を指定します。

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalFilePath

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

Type:FileInfo
Aliases:lf
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NumberOfThreads

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

Type:Int32
Aliases:th
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OverWrite

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

Type:SwitchParameter
Aliases:o
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Source

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

Type:Uri
Aliases:src
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageKey

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

Type:String
Aliases:sk
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False