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]
     [-FileMode <String>]
     [-Owner <String>]
     [-Group <String>]
     [-OwnerCopyMode <String>]
     [-FileModeCopyMode <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

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

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

Start-AzStorageFileCopy
     -SrcFile <ShareFileClient>
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-FileMode <String>]
     [-Owner <String>]
     [-Group <String>]
     [-OwnerCopyMode <String>]
     [-FileModeCopyMode <String>]
     [-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 名稱

範例 3：從檔案到具有目的地檔案上特定 FileMode、擁有者、群組的檔案開始複製作業

Start-AzStorageFileCopy -SrcShareName "contososhare01" -SrcFilePath "FilePath01" -DestShareName "contososhare02" -DestFilePath "FilePath02" -FileMode rw-rwx-wT -Owner 1 -Group 1 -FileModeCopyMode Override -OwnerCopyMode Override

此命令會啟動從檔案到檔案的複製作業，並在目的地檔案上使用特定的 FileMode、Owner、Group。 如果目的地檔案應具有相同的 FileMode、Owner、Group 做為來源檔案、指定 “-FileModeCopyMode Source” 和 “-OwnerCopyMode Source”，則不應該指定 FileMode、Owner、Group 參數。 如果未指定所有參數 FileModeCopyMode、OwnerCopyMode、FileMode、Owner、Group，目的地檔案將會有預設的 FileMode、Owner、Group。 FileMode、擁有者、群組僅適用於 NFS 檔案共用。

參數

-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

-FileMode

要設定於目的地檔案上的模式許可權。 僅適用於 NFS 檔案。 只能與 參數 -FileModeCopyMode Override搭配使用。 支援符號 （rwxrw-rw-） 。

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

-FileModeCopyMode

僅適用於 NFS 檔案。 值 「Override」 必須與 參數 -FileMode一起指定。 如果未指定，目的地檔案將具有預設的檔案模式。

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

-Force

強制命令執行，而不要求使用者確認。

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

-Group

要設定在目的地檔案上的擁有者群組標識碼 （GID）。 僅適用於 NFS 檔案。 需要與 參數 -OwnerCopyMode Override一起指定 。

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

-Owner

要設定在目的地檔案上的擁有者用戶標識碼 （UID）。 僅適用於 NFS 檔案。 需要與 參數 -OwnerCopyMode Override一起指定 。

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

-OwnerCopyMode

僅適用於 NFS 檔案。 值 「Override」 必須與 參數 -Owner 和 -Group一起指定。 如果未指定，目的地檔案將會有預設的擁有者和群組。

類型:	String
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 執行時會發生什麼事。 指令未執行。

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

輸入

CloudBlob

ShareFileClient

IStorageContext

輸出

AzureStorageFile

相關連結

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