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 或更新版本 |
| 工作類別 | 公用程式 |