使用此任务可以使用匹配模式将文件从源文件夹复制到目标文件夹。 (匹配模式将仅匹配文件路径,而不是文件夹路径)。
注释
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,经典生成 |
运行时间 | 代理,DeploymentGroup |
需求 | 没有 |
功能 | 此任务不满足作业中后续任务的任何要求。 |
命令限制 | 任何 |
|
任何 |
代理版本 | 1.91.0 或更高版本 |
任务类别 | 效用 |