Expand-Bzip2 Cmdlet

Parameters   Output Objects   Config Settings  

The Expand-Bzip2 component implements a decompressor for Bzip2 archives.

Syntax

Expand-Bzip2 [parameters]

Remarks

To scan an archive, set the Input parameter to the archive to examine, and set the Format parameter to the appropriate type. A ZipFileInfo object will be returned.

If the Output parameter is set, the cmdlet will attempt to extract the archive to the specified location. A single ZipFileInfo object will be returned indicating the success of the operation and the number of extracted files.

The cmdlets support pipeline input for some of their parameters. Prebuilding an object and piping it to the cmdlet is very useful, but should be used with caution to prevent security conflicts. Steps have been taken to decrease the risk of a possibly accidental pipe to the cmdlet, for instance, the Credential parameter cannot be piped to the cmdlet and must be specified manually.

# scan an archive Expand-Bzip2 -Input "simple.bz2" # extract files from an archive Expand-Bzip2 -input "C:\simple.bz2" -output "C:\temp"

Parameter List

---

The following is the full list of the parameters of the cmdlet with short descriptions. Click on the links for further details.

LogFile	The location of a file to which debug information is written.
Config	Specifies one or more configuration settings.
Input	The archive file from which to read.
LogFile	The location of a file to which debug information is written.
Output	The directory where the files will be decompressed.

Output Objects

---

The following is the full list of the output objects returned by the cmdlet with short descriptions. Click on the links for further details.

ZipFileInfo	Information about the entries in the archive.

Config Settings

---

The following is a list of config settings for the cmdlet with short descriptions. Click on the links for further details.

BuildInfo	Information about the product's build.
CodePage	The system code page used for Unicode to Multibyte translations.
LicenseInfo	Information about the current license.
MaskSensitive	Whether sensitive data is masked in log messages.
UseInternalSecurityAPI	Tells the component whether or not to use the system security libraries or an internal implementation.

LogFile Parameter (Expand-Bzip2 Cmdlet)

The location of a file to which debug information is written.

Syntax

Expand-Bzip2 -LogFile string

Remarks

When specified, the cmdlet will log debug information to the file. If the file exists, the information will be appended.

Default Value

null

Config Property (Expand-Bzip2 Cmdlet)

Specifies one or more configuration settings.

Syntax

Expand-Bzip2 -Config string[]

Remarks

The Config parameter takes one or more name-value pairs that represent the name of the configuration setting and value, i.e.: -config "Name=Value"

Default Value

null

Input Property (Expand-Bzip2 Cmdlet)

The archive file from which to read.

Syntax

Expand-Bzip2 -Input string

Remarks

This parameter indicates the archive file to decompress.

Default Value

""

Parameter Position

0

Parameter Alias

in

This is a required parameter.

LogFile Property (Expand-Bzip2 Cmdlet)

The location of a file to which debug information is written.

Syntax

Expand-Bzip2 -LogFile string

Remarks

When specified, the cmdlet will log debug information to the file. If the file exists, the information will be appended.

Default Value

""

Output Property (Expand-Bzip2 Cmdlet)

The directory where the files will be decompressed.

Syntax

Expand-Bzip2 -Output string

Remarks

If a value is specified, the cmdlet will attempt to extract the archive to that location. An output value of empty string will result in the archive being extracted to the current directory. If no output directory is specified, the cmdlet will only scan the archive without decompressing it.

Default Value

""

Parameter Alias

out

ZipFileInfo Output Object (Expand-Bzip2 Cmdlet)

Information about the entries in the archive.

Syntax

Object ZipFileInfo {
   string CompressedName;
   string DecompressedName;
   bool IsDirectory;
   long Length;
}

Remarks

For every entry found in the archive, a ZipFileInfo object will be returned.

CompressedName is the name of the entry in the archive, including any directory information.

DecompressedName is the name of the extracted archive (if extracting).

IsDirectory is true if this is a directory entry, false otherwise.

Length is the size, in bytes, of the entry.

Note: During a scan operation for the GZIP Format, the length cannot be computed and it's always 0.

Config Settings (Expand-Bzip2 Cmdlet)

The cmdlet accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the cmdlet, access to these internal properties is provided through the Config method.

Base Config Settings