Add-SevenZip Cmdlet

Parameters   Output Objects   Config Settings  

The Add-SevenZip cmdlet allows for the appending of a file to an existing 7z archive.

Syntax

Add-SevenZip [parameters]

Remarks

To add one or more files to a pre-existing 7z archive, set the Input parameter to the list of files to add and the Output parameter to the the target archive.

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. # add the contents of a directory to an existing .7z archive Add-SevenZip -Input "C:/temp" -Output "archive.7z" -Recurse

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.
FileCompressedName	Specifies the path and filename of the file in the archive.
Input	The files to be added to the archive.
LogFile	The location of a file to which debug information is written.
Output	The archive file.
Password	The password for the zip archive.
Recurse	Whether or not to recurse into subdirectories.

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.

ZipFile	Returned after appending file(s) to 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 (Add-SevenZip Cmdlet)

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

Syntax

Add-SevenZip -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 (Add-SevenZip Cmdlet)

Specifies one or more configuration settings.

Syntax

Add-SevenZip -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

FileCompressedName Property (Add-SevenZip Cmdlet)

Specifies the path and filename of the file in the archive.

Syntax

Add-SevenZip -FileCompressedName string

Remarks

This parameter is optional and may be set to specify the path and name of the file as it exists in the archive. By default the cmdlet will automatically determine this value. If path information is specified it must be specified in a Unix style format. For instance "myfolder/myfile.txt".

This parameter is only applicable when adding a single file to the archive. If multiple files are added this parameter is ignored.

Default Value

""

Input Property (Add-SevenZip Cmdlet)

The files to be added to the archive.

Syntax

Add-SevenZip -Input string[]

Remarks

The parameter can contain directory paths as well, where everything in the directory needs to be included in the compressed file.

Default Value

null

Parameter Position

0

Parameter Alias

files

This is a required parameter.

LogFile Property (Add-SevenZip Cmdlet)

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

Syntax

Add-SevenZip -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 (Add-SevenZip Cmdlet)

The archive file.

Syntax

Add-SevenZip -Output string

Remarks

Specifies the name of the compressed file to be appended to.

Default Value

""

Parameter Position

1

Parameter Alias

out

Password Property (Add-SevenZip Cmdlet)

The password for the zip archive.

Syntax

Add-SevenZip -Password string

Remarks

The EncryptionAlgorithm of the compressed file determines the AES encryption strength.

Default Value

""

Recurse Property (Add-SevenZip Cmdlet)

Whether or not to recurse into subdirectories.

Syntax

Add-SevenZip -Recurse SwitchParameter

Remarks

If Input includes directory paths, this setting indicates whether a recursive search for files should be done by the cmdlet.

Default Value

false

ZipFile Output Object (Add-SevenZip Cmdlet)

Returned after appending file(s) to archive.

Syntax

Object ZipFile {
   string File;
   long Size;
   bool Secure;
}

Remarks

After successfully appending a file(s), the ZipFile object is returned.

File contains the full path of the compressed file.

Size contains the file size of the compressed file.

Secure indicates whether or not the file was password protected.

Config Settings (Add-SevenZip 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