共用方式為


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

另請參閱