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 或更高版本
任务类别	实用工具

另请参阅

• CopyFiles@2