ExtractFiles@1 - 提取文件 v1 任务

使用此任务可提取各种存档和压缩文件，例如 .7z、.rar、.tar.gz 和 .zip。

语法

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

输入

archiveFilePatterns - 存档文件模式
string. 必需。 默认值：**/*.zip。

指定要提取的存档文件的文件路径或模式。 支持多行小型匹配模式。 详细了解 “提取文件”任务。

指定要与要提取的存档匹配的模式。 默认情况下，模式从存储库的根文件夹中开始， (与指定 $(Build.SourcesDirectory)相同。
指定模式筛选器，每行一个，与要提取的存档匹配。 例如：

• test.zip 提取根文件夹中test.zip文件。
• test/*.zip 提取测试文件夹中的所有.zip文件。
• **/*.tar 提取根文件夹和子文件夹中的所有 .tar 文件。
• **/bin/*.7z 提取名为“bin”的任何子文件夹中的所有 .7z 文件。
  该模式用于仅匹配存档文件路径，而不匹配文件夹路径，不匹配要提取的存档内容。 因此，应指定模式，例如 **/bin/** ，而不是 **/bin。

destinationFolder - 目标文件夹
string. 必需。

指定存档文件应提取到的目标文件夹。 如果文件不在存储库中，请使用 变量 。 例如：$(agent.builddirectory)。

cleanDestinationFolder - 在提取之前清理目标文件夹
boolean. 默认值：true。

指定在将存档内容提取到目标目录之前清理该目录的选项。

overwriteExistingFiles - 覆盖现有文件
boolean. 默认值：false。

指定覆盖目标目录中的现有文件（如果它们已存在）的选项。 如果 选项为 false，则脚本会提示现有文件，询问是否要覆盖它们。

pathToSevenZipTool - 7z 实用工具的路径
string.

指定 7z 实用工具的自定义路径。 例如， C:\7z\7z.exe 在 Windows 和 /usr/local/bin/7z MacOS/Ubuntu 上。 如果未在 Windows 上指定，将使用随任务一起提供的默认 7zip 版本。

任务控件选项

除任务输入外，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

无。

备注

使用此任务使用匹配模式将文件从存档提取到目标文件夹。 支持一系列标准存档格式，包括.zip、.jar、.war、.ear、.tar、.7z 等。

有关文件匹配模式的详细信息，请参阅 文件匹配模式参考。

示例

以递归方式提取所有.zip文件

此示例将以递归方式提取所有.zip文件，包括根文件和子文件夹中的文件。

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

从子文件夹提取所有.zip文件

此示例将提取 test/one.zip 和 test/two.zip，但将保留 test/nested/three.zip。

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

要求

要求	说明
管道类型	YAML，经典内部版本，经典发布
运行平台	Agent、DeploymentGroup
需求	无
功能	此任务不满足作业中后续任务的任何要求。
命令限制	此任务使用以下命令 限制运行：受限
可设置的变量	此任务有权 设置以下变量：禁用设置变量
代理版本	2.182.1 或更高版本
任务类别	实用工具

另请参阅

• 文件匹配模式参考