ActivID ActivClient Setup Customization Using Command Line or PowerShell
This section describes how to use a command line to customize the ActivID ActivClient setup.
-
You must be logged on as a local administrator in order to execute these commands.
-
In all command line examples provided in the following sections, the ActivClient setup file name is referenced as <ActivClient setup>.msi, where <ActivClient setup> is the appropriate name for the ActivClient version in use. For example, the setup file name for version 8.2.0 is ActivClient-8.2.0.msi.
Basic Install Command Line
The basic command line used to install the product with Microsoft Installer is:
msiexec.exe /i "<path>\<ActivClient setup>.msi"
where:
-
<path> is the ActivClient setup MSI file path.
-
<ActivClient setup> is the ActivClient setup MSI file name.
This command allows installation of the default ActivClient setup, just as when double-clicking the ActivClient Setup file.
Exclude Features
To exclude one or several features from the setup program, use the following command:
msiexec /i <path to msi> AddLocal=ALL Remove=<FeatureName1>,<FeatureName2>
where:
-
<path> is the ActivClient setup MSI file path.
-
<ActivClient setup> is the ActivClient setup MSI file name.
-
<FeatureName> is the name of the feature to remove. See section Customize the Feature Installation for more information.
Example:
To install all the features, excluding the Pin Init Tool, use the following command:
msiexec /i ActivClient.msi AddLocal=ALL Remove=InitTool
Remove Features From Existing Installation
To remove one or several features from an existing installation, use the following command:
msiexec /i "<path>\<ActivClient setup>.msi" Remove=<FeatureName>
where:
-
<path> is the ActivClient setup MSI file path.
-
<ActivClient setup> is the ActivClient setup MSI file name.
-
<FeatureName> is the name of the feature to remove. See section Customize the Feature Installation for more information.
Example:
To remove the User Console feature, use the following command:
msiexec.exe /i "<path>\<ActivClient setup>.msi" Remove=UserConsole
Force Features
To force installation of one or several features from the setup program, use the following command:
msiexec.exe /i "<path>\<ActivClient setup>.msi" AddLocal= FeatureName1
where:
-
<path> is the ActivClient setup MSI file path.
-
<ActivClient setup> is the ActivClient setup MSI file name.
-
<FeatureName1> is the name of the feature to install. See section Customize the Feature Installation for more information.
When installing ActivClient, you need to list all the features that you want to install.
Example:
To install the MiniDriver, OutLook, and PKCS features, use the following command:
msiexec.exe /i "<path>\<ActivClient setup>.msi" AddLocal=MiniDriver,OutLook,PKCS
You can use AddLocal=ALL if you want to install all the ActivClient features.
Add Features to Existing Installation
When modifying an existing installation, you can use AddLocal to add only the features that you want to install.
Use the following command:
msiexec.exe /i "<path>\<ActivClient setup>.msi" AddLocal=<FeatureName1>,<FeatureName2>
where:
-
<path> is the ActivClient setup MSI file path.
-
<ActivClient setup> is the ActivClient setup MSI file name.
-
<FeatureName1> is the name of the feature to install. See section Customize the Feature Installation for more information.
Example:
To add the User Console and PKCS features, use the following command:
msiexec.exe /i "<path>\<ActivClient setup>.msi" AddLocal=UserConsole,PKCS
-
The quotation marks shown in the command line are necessary when there are spaces in the file name.
-
Once ActivClient is installed, you can modify the installed features using the Add or Remove Programs function in the Windows Control Panel.
-
Features removed during initial installation (that is, the features that are not installed) are displayed in the ActivClient Custom Setup screen as unselected, with a red cross, where you can select them for installation.
