For the complete documentation index, see llms.txt. This page is also available as Markdown.

ExtractArchive

A Frends task for extracting zip archives.

Task version: 1.4.0

Required Frends version: 5.5+

Required .NET version: 6.0

Compatible Agents: Crossplatform

Task Parameters

Name
Description

SourceFile : String

Full path to the source file.

Default: - Example: c:\example\file.zip

🗝Password : String

Password for the ZIP file.

Default: - Example: foobar123

DestinationDirectory : String

Destination directory.

Default: - Example: C:\example

Name
Description

DestinationFileExistsAction : UnzipFileExistAction

Action to be taken when destination file/files exist.

Possible values:

  • Error: Action to be taken when destination file/files exist.

  • Overwrite: Action to be taken when destination file/files exist.

  • Rename: Action to be taken when destination file/files exist.

Default: 0 Example: Error

CreateDestinationDirectory : Boolean

Create destination directory if it does not exist.

Default: False Example: false

DeleteZipFileAfterExtract : Boolean

If set to true, the source ZIP file will be deleted after successful extraction.

Default: False Example: true

Task Result

Name
Description

ExtractedFiles : List<String>

a List-object of extracted files. Example: "ExtractedFiles": ["C:\temp\sample.txt", "C:\temp\sample2.txt"]

Task Changelog

Changelog for Task Frends.Zip.ExtractArchive.

[1.4.0] - 2026-05-25

Fixed

  • Fix separators when extracting between different operating systems (e.g. Windows and Linux) to ensure correct file paths.

[1.3.0] - 2025-12-29

Fixed

  • Fix repository url in metadata

[1.2.0] - 2024-12-13

Changed

  • Drop DotNetZip in favour of ProDotNetZip because of security reasons

  • DotNetZip has a HIGH severity directory traversal vulnerability (CVE reported Nov 2024) affecting versions 1.10.1 through 1.16.0 with no patch available (package is deprecated)

  • The migration to ProDotNetZip 1.20.0 addresses this security concern

[1.1.0] - 2024-10-22

Fixed

  • Fixed issue with rename option writing the extracted files to wrong directory.

Added

  • DeleteZipFileAfterExtract option to enable the deletion of the source file.

[1.0.3] - 2022-02-23

Changed

  • Added documentation link to task description

[1.0.2] - 2022-02-23

Changed

  • Added package description

[1.0.1] - 2022-02-23

  • Maintenance

[1.0.0] - 2022-02-23

Added

  • Initial implementation

Last updated

Was this helpful?