Help CenterThreatLocker permits users to install or uninstall ThreatLocker using the ThreatLocker x64 MSI. When installing the ThreatLocker MSI, you can use Command Prompt to add parameters to your installation to change its properties during installation or uninstallation. This article will cover how to install or uninstall ThreatLocker using the MSI as well as a list of parameters.
Installing ThreatLocker Using the MSI
- Open a Windows Command Prompt as Administrator.
- Insert and run the following command:
msiexec.exe /i "<MSI-FILE-PATH> <MSI-FILE-NAME>" <PARAMETERS> /L*V "<LOG-FILE-PATH>"
Note: Change the text within the <> fields to ensure it matches your needs for running the file. Please refer to the end of the KB for information on what these fields mean.
Uninstalling ThreatLocker Using the MSI
- Open a Windows Command Prompt as Administrator.
- Insert and run the following command:
msiexec.exe /x "<MSI-FILE-PATH> OR <MSI-FILE-NAME>" /L*V "<LOG-FILE-PATH>"
|
Section |
Required |
Note |
|
<MSI-FILE-PATH> OR <MSI-FILE-NAME> |
Yes |
Replace <MSI-FILE-PATH> with an absolute or relative file path (i.e. C:\installers\ThreatLockerThreatLocker_abcdefghijklmnopqrstuvwx.msi) OR Replace <MSI-FILE-NAME> with ThreatLocker{_installkey}.msi The 24-character _installkey is mandatory when installing a standard MSI unless it is a custom MSI with an embedded install key or when using the groupkey parameter. (i.e. ThreatLocker_abcdefghijklmnopqrstuvwx.msi) |
|
<PARAMETERS> |
No |
Replace <PARAMETERS> with multiple optional parameters that reflect your system's configuration. Please see the table below for an explanation and a list of applicable parameters. (i.e. msiexec /i ThreatLocker_abcdefghijklmnopqrstuvwx.msi apiurl=https://apiurl.threatlocker.com/ ) |
|
/L*V <LOG-FILE-PATH> |
No |
This optional logging parameter set helps ThreatLocker troubleshoot the installation or uninstallation of an MSI. Replace <LOG-FILE-PATH> with an absolute or relative file path (i.e. C:\logs\ThreatLockerUninstall.log) |
|
Parameters |
Example |
Note |
|
apiurl |
apiurl=https://apiurl.threatlocker.com/ |
|
|
relayurl |
relayurl=https://tl-relay.test.com/ |
This is for a ThreatLocker RELAY Server, NOT a network proxy server. |
|
proxysetting |
proxysetting=https://proxy.corporation.com |
This is for a network proxy server. |
|
proxyservers |
proxyservers="http://x.y.com:[portnumber]|localhost:[portnumber]|http://[ipaddress]:[portnumber]" |
This applies to proxy servers configured in ThreatLocker Advanced Settings. Please use double quotes and a pipe-separated list of URLs. |
|
groupkey |
groupkey=abcdefghijklmnopqrstuvwx |
This is an optional way to use the install key. |