你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Save-AzureVhd

启用 .vhd 映像下载。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

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

说明

Save-AzureVhd cmdlet 可从存储到文件的 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

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为:

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • Suspend
类型:ActionPreference
别名:infa
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InformationVariable

指定信息变量。

类型:String
别名:iv
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LocalFilePath

指定本地文件路径。

类型:FileInfo
别名:lf
Position:2
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NumberOfThreads

指定此 cmdlet 在下载期间使用的下载线程数。

类型:Int32
别名:th
Position:3
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-OverWrite

指定此 cmdlet 删除 LocalFilePath 文件指定的文件(如果存在)。

类型:SwitchParameter
别名:o
Position:5
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Source

指定 Blob 中的 Azure统一资源标识符(URI)。

类型:Uri
别名:src
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-StorageKey

指定 Blob 存储帐户的存储密钥。 如果未提供,Save-AzureVhd 会尝试从 Azure 确定 SourceUri帐户的存储密钥。

类型:String
别名:sk
Position:4
默认值:None
必需:False
接受管道输入:False
接受通配符:False