CopyFiles@1 - 复制文件 v1 任务

可以通过此任务使用匹配模式将文件从源文件夹复制到目标文件夹。 (匹配模式将仅匹配文件路径,而不匹配) 文件夹路径。

注意

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中提供了此任务的较新版本。

如果没有文件匹配,则任务仍将报告成功。 如果目标文件夹中已存在匹配的文件,除非 设置为 true,否则 Overwrite 任务将报告失败。

要求

要求 说明
管道类型 YAML,经典内部版本
运行平台 Agent、DeploymentGroup
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置的变量 任意
代理版本 1.91.0 或更高版本
任务类别 实用工具

另请参阅