.png)
KB - Command Line Installation (silent installs)
Command Line Installation
You can install SecureZIP from the Windows command-line prompt or a batch file. In the command line, you can set values for various properties to customize the installation.
The command line looks like this:
<name of pkzip installation file> /S /v"<properties>"where:
/S is a switch that tells InstallShield® to run silently and not to display various initial screens (that say, for example, Preparing to install )
/v is a switch that must be used to pass any specified SecureZIP properties to the Windows installer.
<properties> is a list of property settings
You can also optionally pass in a switch to specify either the Basic UI, that displays a dialog containing only a Cancel button to allow canceling of the installation; or No UI, that displays no dialog. Both Basic UI and No UI can run unattended. The default is the full, graphical UI, which is interactive and so cannot run unattended.
| Switch | Specifies |
|---|---|
| /qb | Basic UI |
| /qn | No UI |
Any quotes (") in the parameters must be escaped with a backslash (\).
Examples:
<name of pkzip installation file> /S /v/qb
<name of pkzip installation file> /S /v"/qb PKCABASSOC=0"
<name of pkzip installation file> /S /v"PKCABASSOC=0 LICENSE_KEY=<Your license key>"
<name of pkzip installation file> /S /v"INSTALLDIR=\"\My Programs\PKWARE\""The properties you can set or change are described below.
Associate file types with SecureZIP…
By default, the installation associates with SecureZIP the types of files listed in the following table. These file associations enable you to open a file of any of these types in SecureZIP by double-clicking it in Windows Explorer.
File Type Property ZIP PKZIPASSOC UUEncode/XXencoded PKUUEASSOC GZIP and TAR PKGZASSOC BZIP2 PKBZ2ASSOC ARJ PKARJASSOC RAR PKRARASSOC LZH PKLZHASSOC JAR PKJARASSOC CAB PKCABASSOC Z (UNIX compress) PKZASSOC 7Zip PK7ZASSOC Disk Images (ISO, IMG, CDR) PKISOASSOC If you do not want a particular file type associated with SecureZIP, set its corresponding property to 0 in the command line. For example:
CODE<name of pkzip installation file> /S /v"PKCABASSOC=0"By default, the installation creates shortcuts to SecureZIP. If you do not want a shortcut created in one of the places listed in the table below, set the corresponding property to 0.
Location Property Program group on start menu PKSTARTMENU Desktop PKDESKTOP Do not install SecureZIP Attachments...
SecureZIP Attachments, the extension module for zipping email messages and attachments, installs by default if Outlook is detected. To not install SecureZIP Attachments, set the PK_PKZIP_ATT property to No using a command line like this:
CODE<name of pkzip installation file> /S /v"PK_PKZIP_ATT=\"No\""SecureZIP Attachments status...
The SecureZIP Attachments tool tray icon runs in the system tray. If you want it to run each time you start your computer, set the START_PKTRAY property to 1. Otherwise set it to 0. (You can also control display of the tooltray icon from the Start menu command SecureZIP Attachments Status.)
If you want SecureZIP to install somewhere other than the system's Program Files directory, use the INSTALLDIR property and set it to the new location. For example:
CODE<name of pkzip installation file> /S /v"INSTALLDIR=\"\My Programs\PKWARE\""SecureZIP checks the PKWARE license key each time the program runs. Use the LICENSE_KEY property to set the license key on users' systems. For example:
CODE<name of pkzip installation file> /S /v"LICENSE_KEY=<Your license key>"If you have SecureZIP Enterprise and have defined contingency keys or created a policy that you want to apply to a new installation, set the PKPOLICY property to identify the location of the policy file containing your settings. Enter a command line like the following:
CODE<name of pkzip installation file> /S /v"PKPOLICY=\\network\share\pkzipw_policy.szp"The command line sets the PKPOLICY property to the specified name and location of the policy file. (The path and file name shown above are just a sample. You can use any full path and file name. Do not use a relative path.)
If the defined policy file is stored on the network, the network share must be available when running SecureZIP.
Before you can use the policy file, you must also import into each user's registry a key that contains the certificate used to sign the file. You can use SecureZIP Enterprise to create a .reg file that imports policy certificates to the right key. To use such a .reg file, do one of the following:
Set the SecureZIP POLICY_CERTS property to point to and run the .reg file when SecureZIP is installed (see Import Policy Certificates, below).
After installation, run the .reg file on each end-user machine to import its certificates.
If you have SecureZIP Enterprise and have defined contingency keys or created a policy, you can set the POLICY_CERTS property to point to a .reg file that imports policy certificates (used to sign policy files) when SecureZIP is installed. For example:
CODE<name of installation file> /v"POLICY_CERTS=\\network\share\pkpolicycerts.reg"or, using a local path:
CODE<name of installation file> /v"POLICY_CERTS=\"C:\Documents and Settings\jq_public\My Documents\PKWARE\pkpolicycerts.reg\""Note the backslashed quotes around the path in the example above. The quotes are necessary because the path contains spaces.
You can use SecureZIP Enterprise to create a .reg file that contains the key and certificates to import.
Set whether certificate request wizard runs automatically... (DEPRECATED)
SecureZIP users who do not have a PKWARE (Comodo) X.509 certificate can click Get a Digital Certificate in the Help menu to run a certificate request wizard.
You can change this default auto-run behavior (if, for example, you only use OpenPGP for encryption and signing) by setting the PK_CERT_AUTORUN property. Set the property to 1 to enable the wizard to run automatically; set it to 0 to disable auto-run. For example:
<name of pkzip installation file> /S /v"PK_CERT_AUTORUN=0"
Do not install certificate request wizard...
Do not install SaveSecure® feature...SecureZIP users who do not have a PKWARE (Comodo) X.509 certificate can click Get a Digital Certificate in the Help menu to run a certificate request wizard.
You can disable installation of the wizard (and prevent the wizard from ever running) in a command line installation by setting the PK_NO_CERT_REQUEST property to 1:
CODE<name of pkzip installation file> /S /v"PK_NO_CERT_REQUEST=1"The SaveSecure feature adds to Miscellaneous options an Office Integration page that contains options to automatically open an archived file in the file's associated application program, and to enable Office Integration.
The SaveSecure Office Integration option adds menu commands and toolbar buttons to some Microsoft Office applications to make it possible to open documents of appropriate types in the application directly from ZIP files. Documents can also be saved directly to ZIP files using these commands.
To not install the SaveSecure functionality, set the SAVESECURE property to 0:
CODE<name of pkzip installation file> /S /v"SAVESECURE=0"Do not install key backup feature...
By default, the Encryption and Signing pages of Security options contain a Backup button that enables the user to export a backup copy of an X.509 private key to a .pfx file. The user can also export a private key by checking a box in the certificate request wizard, which can be run from the command Get a Digital Certificate in the Help menu.
To hide these controls and not install the key backup functionality, set the PK_KEY_BACKUP property to 0:
CODE<name of pkzip installation file> /S /v"PK_KEY_BACKUP=0"SecureZIP does not backup OpenPGP private keys.
For information on installing earlier versions of SecureZIP from the command line, contact PKWARE Support.