Windows: Install and Uninstall using a Script
  • 10 Nov 2021
  • 1 Minute to read
  • Dark
    Light
  • PDF

Windows: Install and Uninstall using a Script

  • Dark
    Light
  • PDF

The SecureCircle Windows agent can be installed on an endpoint by calling the installer, wherever it may be available on the endpoint. For example, if you placed the installer into a user’s downloads folder, you could run

Install

C:\Users\%username%\Downloads\SecureCircleInstaller.12345.exe

Argument Format

/arg=<details>
  • No spaces between the = sign and the details

Argument Values

/S Silent mode - S must be capitalized, no prompts will appear for the user

/url SecureCircle server url (without https:// prefix) Example: /url=yourserver.yourdomain.com

/inv Invitation ID - Found near the bottom of the Description field when selecting a Circle User. Example: /inv=12345abcde

/proxy If you have a proxy set for use with SecureCircle, you can enter the proxy information using this argument. More information about this function can be found here. https://docs.securecircle.com/docs/agent-http-proxy

/forceupgrade=1 This function will force the upgrade process in the event we release a patch or dot release that is too similar, resulting in the application thinking the same version is already installed.

Example:

C:\Users\%username%\Downloads\SecureCircleInstaller.12345.exe /S /inv=098abc123def765ghih456

Uninstall

The SecureCircle Windows agent can be uninstalled from the endpoint by calling

c:\Program Files (x86)\SecureCircle\uninstall.exe

Arguments:

/S Silent mode - S must be capitalized, no prompts will appear for the user
/keepcircleinfo=true retain local caches.
/keeplogfiles=true retain agent log files.

Changing either of the “keep” options to =false will result in their respective local caches being removed. Removing the local cache for your Circle information can result in the loss of access to encrypted files until reconnecting with the server. If the Circle no longer exists on the server or the key database no longer holds the keys required to access these, access can be lost permanently.

Example:

c:\Program Files (x86)\SecureCircle\uninstall.exe /S /keepcircleinfo=false /keeplogfiles=true

MSI Variables

Alternatively, you could do something similar with the SecureCircle provided MSI. Using the CMD prompt with elevated privileges, you can navigate to the installer's containing folder, and then run the installer using any of the Executable arguments above inside a WRAPPED_ARGUMENTS="var=1" field as the example below.

msiexec /i "path/to/setup.msi" /quiet WRAPPED_ARGUMENTS="/inv=ebd65047d3ef421fbb6325d3121c50ba /url=yourserver.saas.securecircle.com"

The msiexec-specific arguments:

/i Used to run the MSI package to install.
/x Used to run the MSI package to uninstall.
/quiet Used to run the MSI silently, which differs from the /S command which is used to run the executable silently.


Was this article helpful?