使用此工作，使用比對模式，將檔案從源資料夾複製到目標資料夾。 （比對模式只會比對檔案路徑，而不是資料夾路徑）。
備註
CopyFiles@2有較新版本的工作可用。
語法
# 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有較新版本的工作可用。
如果沒有相符的檔案，工作仍會回報成功。 如果目標資料夾中已有相符的檔案，除非 Overwrite 設定為 true，否則工作將會回報失敗。
需求
| 要求 | 說明 |
|---|---|
| 管線類型 | YAML，傳統組建 |
| 執行於 | Agent、DeploymentGroup |
| 需求 | 沒有 |
| 功能 | 此工作不符合作業中後續工作的任何需求。 |
| 命令限制 | 任意 |
| Settable 變數 | 任意 |
| 代理程式版本 | 1.91.0 或更新 |
| 工作類別 | 效用 |