你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Copy-AzStorageBlob
同步复制 Blob。
语法
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>]
Copy-AzStorageBlob
[-BlobBaseClient <BlobBaseClient>]
-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
-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-Az存储Blob 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
Type: | String |
Aliases: | SrcUri, SourceUri |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AsJob
在后台运行 cmdlet
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BlobBaseClient
BlobBaseClient 对象
Type: | BlobBaseClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
源Azure 存储上下文对象
Type: | IStorageContext |
Aliases: | SrcContext, SourceContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestBlob
目标 blob 名称
Type: | String |
Aliases: | DestinationBlob |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestBlobType
目标 Blob 类型
Type: | String |
Accepted values: | Block, Page, Append |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestContainer
目标容器名称
Type: | String |
Aliases: | DestinationContainer |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestContext
目标存储上下文对象
Type: | IStorageContext |
Aliases: | DestinationContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionScope
向 dest blob 发出请求时要使用的加密范围。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
强制覆盖现有 Blob 或文件
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RehydratePriority
块 Blob RehydratePriority。 指示用于解除存档 Blob 冻结的优先级。 有效值为 High/Standard。
Type: | RehydratePriority |
Accepted values: | Standard, High |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SrcBlob
Blob 名称
Type: | String |
Aliases: | SourceBlob |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SrcContainer
源容器名称
Type: | String |
Aliases: | SourceContainer |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StandardBlobTier
块 Blob 层,有效值为热/冷/存档/冷。 请参阅 中的详细信息 https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-storage-tiers
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TagCondition
用于检查匹配条件的可选 Tag 表达式语句。 Blob 标记与给定表达式不匹配时,blob 请求将失败。请参阅详细信息。https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
输出
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈