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>]

Description

Copy-AzStorageBlob Cmdlet 會同步複製 Blob，目前僅支援區塊 Blob。

範例

範例 1：將具名 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"

第一個命令會建立來源 Blob 的 Blob Uri，並具有權限 “rt” 的 sas 權杖。第二個命令會從來源 Blob Uri 複製到目的地 Blob。

範例 4：更新區塊 Blob 加密範圍

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

此命令會使用新的加密範圍將區塊 Blob 加密範圍複製到本身，以更新區塊 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
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Context

來源 Azure 儲存體內容物件

參數屬性

類型:	IStorageContext
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	SrcContext, 來源內容

參數集

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
別名:	目的地 Blob

參數集

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
別名:	目的地容器

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DestContext

目的地儲存環境定義物件

參數屬性

類型:	IStorageContext
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	目的地內容

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EncryptionScope

向目的地 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
別名:	來源 Blob

參數集

ContainerName

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SrcContainer

來源容器名稱

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	來源容器

參數集

ContainerName

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StandardBlobTier

區塊 Blob 層，有效值為 Hot/Cool/Archive/Cold。查看詳細信息 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

Description

範例

範例 1：將具名 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

意見反應