Installing Desktop Central Agent using Windows GPO

How to Install Desktop Central agents using Start Up Script?

Windows GPO is a powerful and versatile tool. Desktop Central agents can be installed on client computers with the help of this tool, even when other installation methods fail for the following reasons:

Clicking on each these reasons provides resolution to the above said problems. If problems still persist with agent installation, then follow the steps given below to use logon script and install agents:

Desktop Central agent installation can also be initiated using GPO lightweight tool. Click here to know the steps for agent installation. 

Note: Ensure that the network has a Domain based setup and not Workgroup setup. You can map the script to the entire domain even if you have installed Desktop Central agents in a few client computers as the script will install the agent only in the computers in which the agent is not installed.

  1. Download the Zip file, extract it and follow the steps given below:
    • Navigate to Admin tab
    • Under SoM Settings, click on Scope of Management
    • Click on Download Agent
    • Select the required office.

      Note: This can be a local office or a remote office depending on which computers you want to install agents in.

  2. Save the .msi & .mst file in this path \\Domain name\SysVol\Domain name\Policies\{ID}\Machine\Scripts\Startup
  3. Click on start>Run
  4. Enter gpmc.msc
  5. Click OK
  6. Right click the domain to select, create and link a GPO here
  7. Specify a name for the GPO
  8. Select the GPO
  9. Note: These steps need to be followed if you wish to install agents in a select few devices (refer this image). Do not follow these steps if you want to install agents in all the devices.
    • Click on the Scope tab
    • Under Security Filtering section, click Add
    • In the Select User, Computer, or Group dialog box, click Object Types
    • Select specific computer object types
    • Click OK
    • Specify the computer names
    • Click on Check Names
    • Click OK
  10. Right click the GPO and click on Edit.
  11. Note: As an alternative to the execution of VBscript, you can execute PowerShell script for agent installation using GPO.

  12. For executing VBScript, follow these steps (refer this image):
    • Expand Computer Configuration --> Policies --> Windows Settings --> Scripts
    • Right click Startup and click Properties
    • Click Show Files
    • Drag and drop the InstallAgent.vbs (download the .txt file and rename it as .vbs) & DesktopCentralAgent.msi DesktopCentralAgent.mst to this location and Copy the location (\\Domain name\SysVol\Domain name\Policies\{ID}\Machine\Scripts\Startup) and close.
    • In the Startup Properties dialog box, click Add
    • Browse and navigate to the location, copy the browsed path (\\Domain name\SysVol\Domain name\Policies\{ID}\Machine\Scripts\Startup) and select InstallAgent.vbs script. Then specify the path (copied location) and the script as mentioned below:
      (\\Domain name\SysVol\Domain name\Policies\{ID}\Machine\Scripts\Startup)\InstallAgent.vbs
    • specify the script parameters as mentioned below:
      DesktopCentralAgent.msi DesktopCentralAgent.mst
  13. For executing PowerShell script, follow these steps and refer this image):
    • Ensure if PowerShell is enabled in all the client computers before execution of this script.
    • Expand Computer Configuration --> Policies --> Windows Settings --> PowerShell scripts
    • Right click Startup and click Properties
    • Click Show Files
    • Drag and drop the PSInstallAgent.ps1 (download the .txt file and rename it as .ps1) & DesktopCentralAgent.msi DesktopCentralAgent.mst to this location and copy the location (\\Domain name\SysVol\Domain name\Policies\{ID}\Machine\Scripts\Startup) and close.
    • In the Startup Properties dialog box, click Add
    • Browse and navigate to the location, copy the browsed path (\\Domain name\SysVol\Domain name\Policies\{ID}\Machine\Scripts\Startup) and select the PSInstallAgent.ps1 script. Then specify the path (copied location) and the script as mentioned below:
      (\\Domain name\SysVol\Domain name\Policies\{ID}\Machine\Scripts\Startup)\PSInstallAgent.ps1
    • specify the script parameters as mentioned below:
      "DesktopCentralAgent.msi" "DesktopCentralAgent.mst"
  14. Click OK to close the Add a Script dialog box
  15. Click OK to close the Startup Properties dialog box
  16. Close the Group Policy Object Editor
  17. Close the Group Policy Management dialog box

Note: The script can be deployed to all the computers in the domain. It is to be noted that the target shouldn't be a user group.

The script will be executed when the client computers reboot after the script is deployed to the domain. After the execution of the script, Desktop Central agents will be installed automatically in all the client computers.

Notes

  • Set the file association properties of .vbs files to Microsoft Windows (r) based script host in all the client computers. This ensures that the script is executed successfully. Do not modify the file association properties to open in a text editor as the execution of the script will fail.
  • You can leave the Desktop Central GPO object installed indefinitely to ensure that the agent is installed in future client computers.
  • This will not re-install the agent that is already installed as the script is programmed to ensure that it doesn't re-install agents that are already installed. This will not cause any problems during startup.
  • You also do not need to update and download the DesktopCentralAgent.msi file every time Desktop Central releases a new version. The agent is programmed to check for new versions from the server and upgrade itself automatically. When an agent is installed, it updates itself automatically when new versions are released.

    You have now installed an agent in client computers using a GPO.

    Configuring IP Scope will help you while you deploy agents using GPO
    • If IP scope is configured for all the remote offices created in Desktop Central server, administrators can directly download local office DesktopCentral_Agent.msi and deploy it in all remote offices using GPO.
    • IP scope has an automatic intelligence to detect computers within the specified IP range and reinstall the appropriate agent for the remote office.
    • Know more on IP Scope here

These are the other ways by which you can proceed with agent installation.

If you still find issues with installing the agents, then feel free to contact our support team at desktopcentral-support@manageengine.com.