Windows Agent Installation Methods

Agent Installation from Web Console

What is Endpoint Central Agent?

Endpoint Central agent is a lightweight software, which needs to be installed on the end-user machine to manage them. The agent is compatible with Windows, Mac and Linux operating systems. To view the complete list of operating systems, check this page.

How to install agent automatically?

To install an agent automatically from the console,

• Navigate to Agent > Computers > Add Computers
• This view will list all the available computers from the selected domain. You can either add a computer from that view to your scope of management (SoM) or install an agent.
• The computers added to your scope of management (SoM) will be listed under computers view. You can select and click the Install Agent button to install an agent on the computer.

How to download and install the agent?

IT administrators can download the agent file and distribute it to the end-users to have them installed on their machine. To do so,

• Navigate to Agent > Computers
• Click the Download Agent button and select the operating system and remote office details.
  Note: Configure the domain settings for Linux under Agent Settings to display the Linux agent file in the download view.
• The downloaded file can be distributed to your end-users. Once installed, the agent will contact the central server and will get listed in your scope of management

How to install agents using the download URL?

IT administrators can share the agent download link to their end-users, using which the Endpoint Central agent can be downloaded and installed. The download URL will be available in the download agent button in computers view. This link will contain the download file for all three operating systems and is available from Endpoint Central Cloud console only.

Agent Installation using active directory

How to install agents remotely?

IT administrators can try the remote installation method to install agents.
Navigate to Agent > Agent Installation > Add computers to your scope of management to install the agent.

How to install agents using GPO scripts?

To install an agent using the gpo script method,

• Navigate to Agent > Agent Installation > Download Agent under GPO.
• Download the agent according to the business requirements. (Selecting the computer platform, remote office)
• Save the .msi, .mst, and DCAgentServerInfo.json files in the network share that you've created.
• Click Start > Run. Enter gpmc.msc and click Ok.
• Right-click the domain, and select Create and Link a GPO here.
• Specify a name for the Group Policy Object (GPO), and select the GPO.
• If you want to install the agent on only a few computers, follow the steps given below; if you want to install the agents on all computers, skip these steps.
  • Click the Scope tab. In the Security Filtering section, click Add.
  • In the Select User, Computer, or Group dialog box, click Object Types.
  • Specify specific computer object types, and click Ok.
  • Specify the computer names, click Check Names, and click Ok.
• Right-click the GPO, and click Edit.
• Expand Computer Configuration > Policies > Windows Settings > Scripts.
• Right-click Startup > Properties > Show Files.
• Download the .txt file and rename it to a .vbs file. Drag and drop the InstallAgent.vbs, UEMSAgent.msi, UEMSAgent.mst, and DCAgentServerInfo.json files to this location. Copy the location (Domain name\Sys Vol\Domain name\Policies\{ID}\Machine\Scripts\Startup) and close the window.
• In the Startup Properties dialog box, click Add.
• Browse and navigate to Domain name\Sys Vol\Domain name\Policies\{ID}\Machine\Scripts\Startup, and select the InstallAgent.vbs script. Alternatively, specify the path you copied and the script below: (Domain name\Sys Vol\Domainname\Policies\{ID}\Machine\Scripts\Startup)\InstallAgent.vbs
• Specify the script parameters as given below:
  UEMSAgent.msi UEMSAgent.mst.
• Click OK to close the Add a Script dialog box.
• Click OK to close the Startup Properties dialog box.
• Close the Group Policy Object Editor, and the Group Policy Management dialog box. The agents will now be installed on the target computers.

Agent Installation using other methods

How to install agents from command line?

To install agents from command line, follow the steps given below:

1. Download the respective remote office agent installer file from Agent -> Agent Installation -> Other Methods -> Download Agent under Command Line option.
2. Extract the zip into a folder in the agent machine
3. Open the command prompt as Administrator from the location where the zip file is extracted.
4. Run the command provided below :

For Endpoint Central version below 10.1.2220.1

msiexec /i "DesktopCentralAgent.msi" /qn TRANSFORMS="DesktopCentralAgent.mst" ENABLESILENT=yes REBOOT=ReallySuppress INSTALLSOURCE=Manual SERVER_ROOT_CRT="%cd%\DMRootCA-Server.crt" DS_ROOT_CRT="%cd%\DMRootCA.crt" /lv "Agentinstalllog.txt"

For Endpoint Central version above 10.1.2220.1

msiexec /i "UEMSAgent.msi" /qn TRANSFORMS="UEMSAgent.mst" ENABLESILENT=yes REBOOT=ReallySuppress INSTALLSOURCE=Manual SERVER_ROOT_CRT="%cd%\DMRootCA-Server.crt" DS_ROOT_CRT="%cd%\DMRootCA.crt" /lv "Agentinstalllog.txt

How to install agents using SCCM?

• Navigate to the Agent tab > Agent Installation > Other methods > Download the zip folder present under SCCM tab.
• Extract the UEMSAgent.msi, UEMSAgent.mst, and DCAgentServerInfo.json files, and paste them in a shared path accessible by all the computers you want to install the agent on.
• Change the shared path location as mentioned in the batch file, and create an SCCM package with this script.
• Deploy this package, and the agents will be installed in the target computers.
• If you have enabled "Waiting for Approval", then further communication with the server occurs only if these target computers are approved from the Waiting for Approval tab that is present at Agent > Computers > Waiting for Approval.

How to install agents with OS Deployment?

For enterprises which have new machines to be managed and where the required operating system has to be deployed, the agent can be deployed with the OS. To know more, visit the link given below:

• Windows OS imaging

How to install agents in AWS Instances?

• Navigate to the Admin tab. Under SoM Settings, select Scope of Management > Download Agent, then select the target office.
• Create an S3 bucket in the region where you want to deploy the agents.
• Upload all the files from the downloaded agent zip folder to the created bucket, and set the permissions as public.
• Create an IAM role for SSM by following the steps below:
  • In the IAM console, navigate to Roles > Create Roles.
  • In the Select type of trusted entity box, choose AWS service.
  • Choose the service EC2.
  • If the specified service has only one use case, it is selected automatically. Choose NEXT: Permissions.

  Use cases are defined by the service to include the trust policy that the service requires.

  • In the Create role window, search for AmazonEC2RoleForSSM, and select it.

  You can also add AmazonEC2RoleForSSM in the already existing IAM role.

  • Choose NEXT: Review.
• Change the EC2 settings.
  • Select the existing instance, and choose Action at the top of the screen.
  • Choose Instance settings and assign the created role.
• In the AWS System Manager console, choose Run Command and run the following command:

  BUCKETPATH is object URL.

  New-Item -ItemType directory -Path C:\\LocalOffice\\localsetup
  $WebClient = New-Object System.Net.WebClient
  $WebClient.DownloadFile("BUCKETPATH/DCAgentServerInfo.json","LOCALPATH/DCAgentServerInfo.json")
  $WebClient.DownloadFile("BUCKETPATH/UEMSAgent.msi","LOCALPATH/UEMSAgent.msi")
  $WebClient.DownloadFile("BUCKETPATH/UEMSAgent.mst","LOCALPATH/UEMSAgent.mst")
  $WebClient.DownloadFile("BUCKETPATH/setup.bat","LOCALPATH/setup.bat") cmd /c msiexec /i
  C:\\LocalOffice\\localsetup\\UEMSAgent.msi REBOOT="REALLYSUPPRESS" MSIRESTARTMANAGERCONTROL="Disable" TRANSFORMS=C:\\LocalOffice\\localsetup\\UEMSAgent.mst ENABLESILENT=yes /qn