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

Get-AzStorageBlobContent

模块:

Az.Storage

下载存储 Blob。

语法

Get-AzStorageBlobContent
   [-Blob] <String>
   [-Container] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Get-AzStorageBlobContent
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Get-AzStorageBlobContent
   -CloudBlobContainer <CloudBlobContainer>
   [-Blob] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Get-AzStorageBlobContent
   [-Destination <String>]
   -AbsoluteUri <String>
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Get-AzStorageBlobContent cmdlet 下载指定的存储 blob。 如果 blob 名称对本地计算机无效，则此 cmdlet 在可能的情况下会自动解析它。

示例

示例 1：按名称下载 Blob 内容

Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

此命令按名称下载 Blob。

示例 2：使用管道下载 Blob 内容

Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent

此命令使用管道查找和下载 Blob 内容。

示例 3：使用管道和通配符下载 Blob 内容

Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

此示例使用星号通配符和管道查找和下载 Blob 内容。

示例 4：获取 Blob 对象并将其保存在变量中，然后使用 blob 对象下载 Blob 内容

$blob = Get-AzStorageBlob -Container containername -Blob blobname 
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"

此示例首先获取 Blob 对象并将其保存在变量中，然后使用 blob 对象下载 Blob 内容。

示例 5：使用 Blob URI 下载 Blob 内容

Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force

此示例将下载包含 Uri 的 Blob 内容，URI 可以是具有 Sas 令牌的 Uri。 如果 Blob 位于托管磁盘帐户上，并且服务器需要 Sas Uri 以外的持有者令牌才能下载，则 cmdlet 将尝试生成包含服务器返回受众的持有者令牌和登录 AAD 用户 credentail，然后下载包含 Sas Uri 和持有者令牌的 Blob。

参数

-AbsoluteUri

要从中下载的 Blob URI。

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

-AsJob

在后台运行 cmdlet。

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

-Blob

指定要下载的 Blob 的名称。

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

-BlobBaseClient

BlobBaseClient 对象

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

-CheckMd5

指定是否检查已下载文件的 Md5 总和。

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

-ClientTimeoutPerRequest

指定一个服务请求的客户端超时间隔（以秒为单位）。 如果上一次调用在指定的时间间隔内失败，则此 cmdlet 将重试请求。 如果此 cmdlet 在间隔过前未收到成功的响应，则此 cmdlet 将返回错误。

类型:	Nullable<T>[Int32]
别名:	ClientTimeoutPerRequestInSeconds
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CloudBlob

指定云 Blob。 若要获取 CloudBlob 对象，请使用 Get-AzStorageBlob cmdlet。

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

-CloudBlobContainer

从 Azure 存储客户端库指定 CloudBlobContainer 对象。 可以创建它或使用 Get-AzStorageContainer cmdlet。

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

-ConcurrentTaskCount

指定最大并发网络调用数。 可以使用此参数通过指定并发网络调用的最大数目来限制本地 CPU 和带宽使用量的并发性。 指定的值是绝对计数，不乘以核心计数。 此参数可帮助减少低带宽环境中的网络连接问题，例如每秒 100 千比特。 默认值为 10。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Container

指定要下载的 Blob 的容器的名称。

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

-Context

指定要从中下载 Blob 内容的 Azure 存储帐户。 可以使用 New-AzStorageContext cmdlet 创建存储上下文。

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Destination

指定要存储已下载文件的位置。

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

-Force

在不确认的情况下覆盖现有文件。

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

-ServerTimeoutPerRequest

指定请求的服务端超时间隔（以秒为单位）。 如果服务处理请求之前指定的间隔已过，则存储服务将返回错误。

类型:	Nullable<T>[Int32]
别名:	ServerTimeoutPerRequestInSeconds
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TagCondition

用于检查匹配条件的可选标记表达式语句。 Blob 标记与给定表达式不匹配时，blob 请求将失败。 请参阅 https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations 中的详细信息。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

输入

CloudBlob

CloudBlobContainer

IStorageContext

输出

AzureStorageBlob

备注

• 如果 blob 名称对本地计算机无效，则此 cmdlet 会自动解决该名称（如果可能）。

相关链接

• Set-AzStorageBlobContent
• Get-AzStorageBlob
• Remove-AzStorageBlob