Start-AzStorageFileCopy

模組:

Az.Storage

開始複製來源檔案。

語法

Start-AzStorageFileCopy
     -SrcBlobName <String>
     -SrcContainerName <String>
     -DestShareName <String>
     -DestFilePath <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DisAllowDestTrailingDot]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcBlobName <String>
     -SrcContainer <CloudBlobContainer>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcBlob <CloudBlob>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcBlob <CloudBlob>
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcFilePath <String>
     -SrcShareName <String>
     -DestShareName <String>
     -DestFilePath <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DisAllowSourceTrailingDot]
     [-DisAllowDestTrailingDot]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcFilePath <String>
     -SrcShare <ShareClient>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcFile <ShareFileClient>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcFile <ShareFileClient>
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -AbsoluteUri <String>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -AbsoluteUri <String>
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Start-AzStorageFileCopy Cmdlet 會開始將來源檔案複製到目的地檔案。 此 Cmdlet 會觸發異步 Blob 複製，複製程式是由伺服器處理。 如果這是跨帳戶 Blob 複本，則 Blob 複製沒有 SLA。

範例

範例 1：使用共享名稱和檔名，從檔案複製到檔案開始複製作業

Start-AzStorageFileCopy -SrcShareName "ContosoShare01" -SrcFilePath "FilePath01" -DestShareName "ContosoShare02" -DestFilePath "FilePath02"

此命令會啟動從檔案到檔案的複製作業。 命令會指定共享名稱和檔名

範例 2：使用容器名稱和 Blob 名稱，開始將作業從 Blob 複製到檔案

Start-AzStorageFileCopy -SrcContainerName "ContosoContainer01" -SrcBlobName "ContosoBlob01" -DestShareName "ContosoShare" -DestFilePath "FilePath02"

此命令會啟動從 Blob 到檔案的複製作業。 命令會指定容器名稱和 Blob 名稱

參數

-AbsoluteUri

指定來源檔案的 URI。 如果來源位置需要認證，您必須提供認證。

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

-ClientTimeoutPerRequest

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

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

-DefaultProfile

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

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

-DestContext

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

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

-DestFilePath

指定目的地檔案相對於目的地共享的路徑。

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

-DestShareFileClient

ShareFileClient 物件指出 Dest 檔案。

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

-DestShareName

指定目的地共享的名稱。

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

-DisAllowDestTrailingDot

不允許尾端點 （.） 後綴目的地目錄和目的地檔名。

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

-DisAllowSourceTrailingDot

不允許尾端點 （.） 後綴來源目錄和來源檔名。

類型:	SwitchParameter
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

-SrcBlob

指定 CloudBlob 物件。 您可以使用 Get-AzStorageBlob Cmdlet 來建立雲端 Blob 或取得一個。

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

-SrcBlobName

指定來源 Blob 的名稱。

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

-SrcContainer

指定雲端 Blob 容器物件。 您可以建立雲端 Blob 容器物件，或使用 Get-AzStorageContainer Cmdlet。

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

-SrcContainerName

指定來源容器的名稱。

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

-SrcFile

指定 shareFileClient 物件的 。 您可以使用 get-AzStorageFile來建立 ShareFileClient 或取得 ShareFile。

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

-SrcFilePath

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

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

-SrcShare

指定雲端檔案共享物件。 您可以使用 Get-AzStorageShare Cmdlet 來建立雲端檔案共用或取得一個。

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

-SrcShareName

指定來源共享的名稱。

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

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

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

輸入

CloudBlob

ShareFileClient

IStorageContext

輸出

AzureStorageFile

相關連結

• Get-AzStorageBlob
• Get-AzStorageContainer
• Get-AzStorageFile
• Get-AzStorageShare
• Get-AzStorageFileCopyState
• Stop-AzStorageFileCopy