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

Copy-AzStorageBlob

模块:: Az.Storage Module

同步复制 Blob。

语法

ContainerName （默认值）

Copy-AzStorageBlob
    [-SrcBlob] <String>
    -SrcContainer <String>
    -DestContainer <String>
    [-DestBlob <String>]
    [-DestBlobType <String>]
    [-StandardBlobTier <String>]
    [-RehydratePriority <RehydratePriority>]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DestContext <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobInstance

Copy-AzStorageBlob
    -DestContainer <String>
    [-BlobBaseClient <BlobBaseClient>]
    [-DestBlob <String>]
    [-DestBlobType <String>]
    [-StandardBlobTier <String>]
    [-RehydratePriority <RehydratePriority>]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DestContext <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UriPipeline

Copy-AzStorageBlob
    -AbsoluteUri <String>
    -DestContainer <String>
    -DestBlob <String>
    [-DestBlobType <String>]
    [-StandardBlobTier <String>]
    [-RehydratePriority <RehydratePriority>]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DestContext <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Copy-AzStorageBlob cmdlet 同步复制 blob，目前仅支持块 Blob。

示例

示例 1：将命名 Blob 复制到另一个 Blob

$destBlob = Copy-AzStorageBlob -SrcContainer "sourcecontainername" -SrcBlob "srcblobname" -DestContainer "destcontainername" -DestBlob "destblobname"

此命令使用新的 Blob 名称将 blob 从源容器复制到目标容器。

示例 2：从 Blob 对象复制 Blob

$srcBlob = Get-AzStorageBlob -Container $containerName -Blob $blobName  -Context $ctx
$destBlob =  $srcBlob | Copy-AzStorageBlob  -DestContainer "destcontainername" -DestBlob "destblobname"

此命令使用新的 Blob 名称将 blob 从源 blob 对象复制到目标容器。

示例 3：从 Blob URI 复制 Blob

$srcBlobUri = New-AzStorageBlobSASToken -Container $srcContainerName -Blob $srcBlobName -Permission rt -ExpiryTime (Get-Date).AddDays(7) -FullUri
$destBlob = Copy-AzStorageBlob -AbsoluteUri $srcBlobUri -DestContainer "destcontainername" -DestBlob "destblobname"

第一个命令使用权限“rt”的 sas 令牌创建源 blob 的 blob URI。第二个命令将源 Blob URI 复制到目标 Blob。

示例 4：更新块 Blob 加密范围

$blob = Copy-AzStorageBlob -SrcContainer $containerName -SrcBlob $blobname -DestContainer $containername -EncryptionScope $newScopeName -Force

此命令通过使用新的加密范围将其复制到自身来更新块 Blob 加密范围。

示例 5：将 Blob 复制到新的追加 blob

$srcBlob = Get-AzStorageBlob -Container $containerName -Blob $blobName  -Context $ctx
$destBlob = Copy-AzStorageBlob -SrcContainer "sourcecontainername" -SrcBlob "srcblobname" -DestContainer "destcontainername" -DestBlob "destblobname" -DestBlobType "Append" -DestContext $destCtx

参数

-AbsoluteUri

源 Blob URI

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	SrcUri, SourceUri

参数集

UriPipeline

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-AsJob

在后台运行 cmdlet

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-BlobBaseClient

BlobBaseClient 对象

参数属性

类型:	BlobBaseClient
默认值:	None
支持通配符:	False
不显示:	False

参数集

BlobInstance

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Context

源Azure 存储上下文对象

参数属性

类型:	IStorageContext
默认值:	None
支持通配符:	False
不显示:	False
别名:	SrcContext, SourceContext

参数集

ContainerName

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

BlobInstance

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-DefaultProfile

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

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DestBlob

目标 Blob 名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	DestinationBlob

参数集

ContainerName

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

BlobInstance

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DestBlobType

目标 Blob 类型

参数属性

类型:	String
默认值:	None
接受的值:	Block, Page, Append
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DestContainer

目标容器名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	DestinationContainer

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DestContext

目标存储上下文对象

参数属性

类型:	IStorageContext
默认值:	None
支持通配符:	False
不显示:	False
别名:	DestinationContext

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EncryptionScope

向 dest blob 发出请求时要使用的加密范围。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Force

强制覆盖现有 Blob 或文件

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RehydratePriority

块 Blob RehydratePriority。指示用于解除存档 Blob 冻结的优先级。有效值为 High/Standard。

参数属性

类型:	Microsoft.Azure.Storage.Blob.RehydratePriority
默认值:	None
接受的值:	Standard, High
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SrcBlob

Blob 名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	SourceBlob

参数集

ContainerName

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SrcContainer

源容器名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	SourceContainer

参数集

ContainerName

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-StandardBlobTier

块 Blob 层，有效值为热/冷/存档/冷。请参阅中的详细信息 https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-storage-tiers

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	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
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

Copy-AzStorageBlob

语法

ContainerName （默认值）

BlobInstance

UriPipeline

说明

示例

示例 1：将命名 Blob 复制到另一个 Blob

示例 2：从 Blob 对象复制 Blob

示例 3：从 Blob URI 复制 Blob

示例 4：更新块 Blob 加密范围

示例 5：将 Blob 复制到新的追加 blob

参数

-AbsoluteUri

参数属性

参数集

-AsJob

参数属性

参数集

-BlobBaseClient

参数属性

参数集

-Confirm

参数属性

参数集

-Context

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DestBlob

参数属性

参数集

-DestBlobType

参数属性

参数集

-DestContainer

参数属性

参数集

-DestContext

参数属性

参数集

-EncryptionScope

参数属性

参数集

-Force

参数属性

参数集

-RehydratePriority

参数属性

参数集

-SrcBlob

参数属性

参数集

-SrcContainer

参数属性

参数集

-StandardBlobTier

参数属性

参数集

-TagCondition

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

BlobBaseClient

String

IStorageContext

输出

AzureStorageBlob

反馈