CopyFiles@1 - 複製檔案 v1 工作

使用此工作，使用比對模式，將檔案從源資料夾複製到目的檔案夾。 (比對模式只會比對檔案路徑，而不是資料夾路徑) 。

注意

CopyFiles@2有較新版本的工作可用。

Syntax

# Copy Files v1
# Copy files from source folder to target folder using minimatch patterns (The minimatch patterns will only match file paths, not folder paths).
- task: CopyFiles@1
  inputs:
    #SourceFolder: # string. Source Folder. 
    Contents: '**' # string. Required. Contents. Default: **.
    TargetFolder: # string. Required. Target Folder. 
  # Advanced
    #CleanTargetFolder: false # boolean. Clean Target Folder. Default: false.
    #OverWrite: false # boolean. Overwrite. Default: false.
    #flattenFolders: false # boolean. Flatten Folders. Default: false.

輸入

SourceFolder - 源資料夾
string.

選擇性。 包含您要複製之檔案的資料夾。 如果資料夾是空的，則工作會從存放庫的根資料夾複製檔案，就像已指定一樣 $(Build.SourcesDirectory) 。

如果您的組建在來原始目錄之外產生成品，請指定 $(Agent.BuildDirectory) 從為管線建立的目錄複寫檔案。

Contents - 內容
string. 必要。 預設值：**。

要包含在複本中的檔案路徑。 此字串支援多行比對模式。

例如：

• * 會複製指定之源資料夾中的所有檔案。
• ** 會複製指定之源資料夾中的所有檔案，以及所有子資料夾中的所有檔案。
• **\bin\** 以遞迴方式從任何 bin 資料夾複製所有檔案。

此模式只用來比對檔案路徑，而不是資料夾路徑。 指定模式，例如 **\bin\** ，而不是 **\bin 。

使用符合組建代理程式類型的路徑分隔符號。 例如， / 必須用於 Linux 代理程式。 以下顯示更多範例。

TargetFolder - 目的檔案夾
string. 必要。

將包含所複製檔案的目的檔案夾或 UNC 路徑。 您可以使用 變數。 範例： $(build.artifactstagingdirectory).

CleanTargetFolder - 清除目的檔案夾
boolean. 預設值：false。

選擇性。 在複製程式之前，刪除目的檔案夾中的所有現有檔案。

OverWrite - 覆蓋
boolean. 預設值：false。

選擇性。 取代目的檔案夾中的現有檔案。

flattenFolders - 扁平化資料夾
boolean. 預設值：false。

選擇性。 將資料夾結構扁平化，並將所有檔案複製到指定的目的檔案夾。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制選項和一般工作屬性。

輸出變數

無。

備註

CopyFiles@2有較新版本的工作可用。

如果沒有相符的檔案，工作仍會回報成功。 如果目的檔案夾中已有相符的檔案，除非設定為 true，否則工作將會回報失敗 Overwrite 。

規格需求

需求	描述
管線類型	YAML、傳統組建
在 上執行	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
可設定變數	任何
代理程式版本	1.91.0 或更新版本
工作類別	公用程式

另請參閱

• CopyFiles@2