Get-ChocolateyUnzip

Unzips an archive file and returns the location for further processing.

Syntax

Get-ChocolateyUnzip `
  [-FileFullPath <String>] `
  -Destination <String> `
  [-SpecificFolder <String>] `
  [-PackageName <String>] `
  [-FileFullPath64 <String>] `
  [-IgnoredArguments <Object[]>] [<CommonParameters>]

Description

This unzips files using the 7-zip command line tool 7z.exe.
Supported archive formats are listed at:
https://sevenzip.osdn.jp/chm/general/formats.htm
Prior to 0.9.10.1, 7za.exe was used. Supported archive formats for
7za.exe are: 7z, lzma, cab, zip, gzip, bzip2, and tar.

Notes

If extraction fails, an exception is thrown.

If you are embedding files into a package, ensure that you have the
rights to redistribute those files if you are sharing this package
publicly (like on the community feed). Otherwise, please use
Install-ChocolateyZipPackage to download those resources from their
official distribution points.

Starting in 0.9.10, will automatically call Set-PowerShellExitCode to
set the package exit code based on 7-zip's exit code.

Aliases

None

Examples

EXAMPLE 1


# Path to the folder where the script is executing
$toolsDir = (Split-Path -parent $MyInvocation.MyCommand.Definition)
Get-ChocolateyUnzip -FileFullPath "c:\someFile.zip" -Destination $toolsDir

Inputs

None

Outputs

None

Parameters

-FileFullPath [<String>]

This is the full path to the zip file. If embedding it in the package
next to the install script, the path will be like
"$(Split-Path -Parent $MyInvocation.MyCommand.Definition)\\file.zip"

In 0.10.1+, File is an alias for FileFullPath.

This can be a 32-bit or 64-bit file. This is mandatory in earlier versions
of Chocolatey, but optional if FileFullPath64 has been provided.

Property Value
Aliases file
Required? false
Position? 1
Default Value
Accept Pipeline Input? false

-Destination <String>

This is a directory where you would like the unzipped files to end up.
If it does not exist, it will be created.

Property Value
Aliases
Required? true
Position? 2
Default Value
Accept Pipeline Input? false

-SpecificFolder [<String>]

OPTIONAL - This is a specific directory within zip file to extract.

Property Value
Aliases
Required? false
Position? 3
Default Value
Accept Pipeline Input? false

-PackageName [<String>]

OPTIONAL - This will faciliate logging unzip activity for subsequent
uninstalls

Property Value
Aliases
Required? false
Position? 4
Default Value
Accept Pipeline Input? false

-FileFullPath64 [<String>]

Full file path to a 64-bit native installer to run. Available in 0.10.4+.
If embedding in the package, you can get it to the path with
"$(Split-Path -parent $MyInvocation.MyCommand.Definition)\\INSTALLER_FILE"

Provide this when you want to provide both 32-bit and 64-bit
installers or explicitly only a 64-bit installer (which will cause a package
install failure on 32-bit systems).

Property Value
Aliases file64
Required? false
Position? named
Default Value
Accept Pipeline Input? false

-IgnoredArguments [<Object[]>]

Allows splatting with arguments that do not apply. Do not use directly.

Property Value
Aliases
Required? false
Position? named
Default Value
Accept Pipeline Input? false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters http://go.microsoft.com/fwlink/p/?LinkID=113216 .

Function Reference

NOTE: This documentation has been automatically generated from Import-Module "$env:ChocolateyInstall\helpers\chocolateyInstaller.psm1" -Force; Get-Help Get-ChocolateyUnzip -Full.

View the source for Get-ChocolateyUnzip