Silently install and register the Agent (Windows only)

To install Agents in this manner, you download a generic Agent installation package from the Downloads page, and then use it in a custom process that distributes, installs, and registers it on multiple devices at the same time.

Before you begin

Before you install Agents using this procedure, do the following:

• Create users in bulk, for the Agents you plan to install.

  For information how to create users in bulk with the ImportUsers tool, see the ImportUsers Tool Help Center, available on the Connected documentation site.

• Verify that all target computers meet Agent requirements.

• Identify the Connected identity provider (IdP) suffix assigned to your company, which this procedure requires. See how.

  To find your corporate IdP suffix:

  1. Click the HIERARCHY tab.
  2. At the top of the hierarchy, select your company, and then click VIEW ().

  3. In the Sign in URL field, locate the IdP suffix after the last forward slash (/).

     For example, the IdP suffix in the following URL is myCorp:

     https://cmx-us.connected.com/#/idp/myCorp

To silently install and register the Agent

1. In the upper-right corner of the web application, click your name, and then click Downloads.

2. Under Download a Specific Agent on the Downloads page, select a specific Agent, and then download it.

   You can choose any Agent version currently available to your company.

3. In a custom deployment script or a software deployment tool, such as System Center Configuration Manager (SCCM), specify the msiexec command to silently install the Agent.

   The minimum command to support silent installation and registration of the Agent assigned to the US-West data center and located in the current folder is:

   msiexec /qn /i ConnectedSetupUSW64.msi IDPSUFFIX="yourIdpSuffix"

   Where yourIdpSuffix is your company-specific IdP suffix for Connected. You can add additional command-line options to define logging or change the default installation or Connected sync folder location. For the complete command-line syntax and examples, see Agent installer command-line reference (Windows).

4. If your company manages its own encryption keys and this is the initial installation of the Agent on the computer, add commands to distribute and install the Connected device client certificate.

   The Agent requires this certificate to establish a secure connection to Connected Key Management Server. Without it, the Agent will not work correctly. Distribute and install the certificate manually, or if using a custom script or deployment tool to automate the installation process, update it to perform these tasks for you. For more information, see Install the Connected device client certificate.

5. Add the command to automatically start the Agent after installation.

   For example, the following command starts the Agent that was installed in the default location:

   start "C:\Program Files\Connected\ConnectedSystemTrayUI.exe"

   When the Agent starts, it automatically registers the device for the user and starts scanning files on the computer.

6. Initiate Agent deployments using your script or deployment tool.

If the process fails, see the FAQ The Agent install or upgrade process failed, what should I do? for troubleshooting tips.