Start-AzStorageBlobCopy

模組:

Az.Storage

開始複製 Blob。

語法

Start-AzStorageBlobCopy
     [-SrcBlob] <String>
     -SrcContainer <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -CloudBlob <CloudBlob>
     [-BlobBaseClient <BlobBaseClient>]
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -CloudBlob <CloudBlob>
     [-BlobBaseClient <BlobBaseClient>]
     -DestCloudBlob <CloudBlob>
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -CloudBlobContainer <CloudBlobContainer>
     [-SrcBlob] <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcShareName <String>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcShare <CloudFileShare>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcDir <CloudFileDirectory>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcFile <CloudFile>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcFile <CloudFile>
     -DestCloudBlob <CloudBlob>
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -AbsoluteUri <String>
     -DestContainer <String>
     -DestBlob <String>
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Start-AzStorageBlobCopy Cmdlet 會開始複製 Blob。

範例

範例 1：複製具名 Blob

Start-AzStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives" -SrcContainer "ContosoUploads"

此命令會啟動名為 ContosoPlanning2015 之 Blob 的複製作業，從名為 ContosoUploads 的容器複製到名為 ContosoArchives 的容器。

範例 2：取得容器以指定要複製的 Blob

Get-AzStorageContainer -Name "ContosoUploads" | Start-AzStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives"

此命令會使用 Get-AzStorageContainer Cmdlet 取得名為 ContosoUploads 的容器，然後使用管線運算符將容器傳遞至目前的 Cmdlet。 該 Cmdlet 會啟動名為 ContosoPlanning2015 之 Blob 的複製作業。 先前的 Cmdlet 提供來源容器。 DestContainer 參數會將 ContosoArchives 指定為目的地容器。

範例 3：取得容器中的所有 Blob 並加以複製

Get-AzStorageBlob -Container "ContosoUploads" | Start-AzStorageBlobCopy -DestContainer "ContosoArchives"

此命令會使用 get-AzStorageBlob Cmdlet，在名為 ContosoUploads 的容器中取得 Blob，然後使用管線運算符將結果傳遞至目前的 Cmdlet。 該 Cmdlet 會啟動 Blob 的複製作業至名為 ContosoArchives 的容器。

範例 4：複製指定為 物件的 Blob

$SrcBlob = Get-AzStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
$DestBlob = Get-AzStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
Start-AzStorageBlobCopy -ICloudBlob $SrcBlob.ICloudBlob -DestICloudBlob $DestBlob.ICloudBlob

第一個命令會在名為 ContosoUploads 的容器中取得名為 ContosoPlanning2015 的 Blob。 命令會將該物件儲存在 $SrcBlob 變數中。 第二個命令會取得名為 ContosoPlanning2015Archived 的容器中名為 ContosoArchives 的 Blob。 命令會將該物件儲存在 $DestBlob 變數中。 最後一個命令會啟動從來源容器到目的地容器的複製作業。 此命令會使用標準點表示法來指定$SrcBlob和$DestBlob Blob 的 ICloudBlob 物件。

範例 5：從 URI 複製 Blob

$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
Start-AzStorageBlobCopy -AbsoluteUri "http://www.contosointernal.com/planning" -DestContainer "ContosoArchive" -DestBlob "ContosoPlanning2015" -DestContext $Context

此命令會建立名為 ContosoGeneral 的帳戶內容，該帳戶會使用指定的密鑰，然後將該密鑰儲存在$Context變數中。 第二個命令會將檔案從指定的 URI 複製到名為 ContosoArchive 的容器中名為 ContosoPlanning 的 Blob。 命令會將複製作業啟動至儲存在 $Context 中的目的地內容。 沒有來源記憶體內容，因此來源 URI 必須具有來源物件的存取權。 例如：如果來源是無公用 Azure Blob，Uri 應該包含 SAS 令牌，其具有 Blob 的讀取許可權。

範例 6：將區塊 Blob 複製到具有新 Blob 名稱的目的地容器，並將目的地 Blob StandardBlobTier 設定為 Hot、RehydratePriority 為 High

Start-AzStorageBlobCopy -SrcContainer "ContosoUploads" -SrcBlob "BlockBlobName" -DestContainer "ContosoArchives" -DestBlob "NewBlockBlobName" -StandardBlobTier Hot -RehydratePriority High

此命令會以新的 Blob 名稱啟動區塊 Blob 至目的地容器的複製作業，並將目的地 Blob StandardBlobTier 設定為 Hot、RehydratePriority 為 High

參數

-AbsoluteUri

指定要複製到 Azure 記憶體 Blob 的檔案絕對 URI。

類型:	String
別名:	SrcUri, SourceUri
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-BlobBaseClient

BlobBaseClient 物件

類型:	BlobBaseClient
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ClientTimeoutPerRequest

指定一個服務要求的用戶端超時時間間隔，以秒為單位。 如果先前的呼叫在指定的間隔內失敗，此 Cmdlet 會重試要求。 如果此 Cmdlet 在間隔經過之前未收到成功的回應，此 Cmdlet 會傳回錯誤。

類型:	Nullable<T>[Int32]
別名:	ClientTimeoutPerRequestInSeconds
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CloudBlob

從 Azure 記憶體用戶端連結庫指定 CloudBlob 物件。 若要取得 CloudBlob 物件，請使用 Get-AzStorageBlob Cmdlet。

類型:	CloudBlob
別名:	SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-CloudBlobContainer

從 Azure 記憶體用戶端連結庫指定 CloudBlobContainer 物件。 此 Cmdlet 會從此參數指定的容器複製 Blob。 若要取得 CloudBlobContainer 物件，請使用 Get-AzStorageContainer Cmdlet。

類型:	CloudBlobContainer
別名:	SourceCloudBlobContainer
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

-Context

指定 Azure 記憶體內容。 若要取得記憶體內容，請使用 New-AzStorageContext Cmdlet。

類型:	IStorageContext
別名:	SrcContext, SourceContext
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DestBlob

指定目的地 Blob 的名稱。

類型:	String
別名:	DestinationBlob
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DestCloudBlob

指定 CloudBlob 物件的目的地

類型:	CloudBlob
別名:	DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DestContainer

指定目的地容器的名稱。

類型:	String
別名:	DestinationContainer
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DestContext

指定 Azure 記憶體內容。 若要取得記憶體內容，請使用 New-AzStorageContext Cmdlet。

類型:	IStorageContext
別名:	DestinationContext
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DestTagCondition

選擇性標記表達式語句，以檢查目的地 Blob 上的比對條件。 當目的地 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

-Force

指出此 Cmdlet 會覆寫目的地 Blob，而不提示您進行確認。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PremiumPageBlobTier

進階分頁 Blob 層

類型:	PremiumPageBlobTier
接受的值:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RehydratePriority

區塊 Blob RehydratePriority。 表示要重新凍結封存 Blob 的優先順序。 有效值為高/標準。

類型:	RehydratePriority
接受的值:	Standard, High
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ServerTimeoutPerRequest

指定要求的服務端超時時間間隔，以秒為單位。 如果指定的間隔在服務處理要求之前經過，則記憶體服務會傳回錯誤。

類型:	Nullable<T>[Int32]
別名:	ServerTimeoutPerRequestInSeconds
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SrcBlob

指定來源 Blob 的名稱。

類型:	String
別名:	SourceBlob
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SrcContainer

指定來源容器的名稱。

類型:	String
別名:	SourceContainer
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SrcDir

從 Azure 記憶體用戶端連結庫指定 CloudFileDirectory 物件。

類型:	CloudFileDirectory
別名:	SourceDir
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SrcFile

從 Azure 記憶體用戶端連結庫指定 CloudFile 物件。 您可以建立它或使用 Get-AzStorageFile Cmdlet。

類型:	CloudFile
別名:	SourceFile
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-SrcFilePath

指定來源目錄或來源共用的來源檔案相對路徑。

類型:	String
別名:	SourceFilePath
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SrcShare

從 Azure 記憶體用戶端連結庫指定 CloudFileShare 物件。 您可以建立它或使用 Get-AzStorageShare Cmdlet。

類型:	CloudFileShare
別名:	SourceShare
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SrcShareName

指定來源共享名稱。

類型:	String
別名:	SourceShareName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-StandardBlobTier

區塊 Blob 層，有效值為經常性存取/非經常性存取/封存/冷。 請參閱 https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers 中的詳細數據

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

Blob 標記

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TagCondition

選擇性標記表達式語句，以檢查來源 Blob 上的比對條件。 當來源 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

CloudFile

String

IStorageContext

輸出

AzureStorageBlob

相關連結

• Get-AzStorageBlobCopyState
• Stop-AzStorageBlobCopy