Uninstall the Windows Agent

If you no longer want to monitor a server or workstation, we recommend you remove the Agent from the device. To remove the Agent from a device or multiple devices, you can use the following methods:

You can only remove a device if you are logged in using an account with the General Settings (Devices) permissions enabled. Otherwise the delete option is unavailable.

Dashboard deletion or Agent Uninstalls are non-recoverable actions. When you confirm a deletion, all information stored in relation to the Client, Site or Device(s) is instantly removed from the database and the data is unretrievable.

Ensure that you verify the correct item is selected for removal before you enter the password and confirm the deletion.

Any features and associated Checks deployed by the Agent are removed as part of the uninstall process. This can result in a longer than anticipated uninstall time as each of these programs is removed along with the Agent.

Use the Agent Removal Alerts to receive a notification when Agent removal is completed through a non-Dashboard method. For example, a manual uninstall.

When you delete a device, that action is recorded in the Dashboard User Audit Report. The User Audit Report includes the date/time of the removal, the username, the details of the action, and the Event type such as, Agent Uninstalled Manually from Device.

Automatically Uninstall the Agent

When you delete a device from the Dashboard, the Agent is also uninstalled. Automatic removal includes Agents installed via Group Policy.

  1. Log into the Dashboard
  2. Go to the Servers, Workstations or Mixed pane
  3. Multi-select the devices for removal (Shift and left-click for a range, Control and left-click for specific devices)
  4. Right-click one of the selection or from the Servers, Workstations or Devices drop-down
  5. Select Delete <device-type> > Delete from Dashboard
  6. Verify the number of devices to be deleted
  7. Enter the password of the account you have logged into the Dashboard with to confirm deletion
  8. Click OK to apply

Depending on the Agent cycle, and the features installed, the removal process may take over an hour to complete.

Manually Uninstall the Agent

To uninstall the Agent directly on the device:

If Windows Agent Uninstall Protection is enabled, it locks local Agent uninstalls by requiring an uninstall code to authorize removal. For information about retrieving the uninstall code, see Windows Agent Uninstall Protection.

  1. Log in to the computer
  2. Go to Add/Remove Programs
  3. Select Advanced Monitoring Agent
  4. Uninstall to remove the Agent and all associated programs
  5. Uninstall or upgrade choose whether to completely remove the Agent or perform an upgrade uninstall (removes the program's files, retains the configuration settings for use by the Agent if it is reinstalled on the device)
  6. Click OK to confirm the Agent uninstall

Uninstall the Agent using the Group Policy Object

If the Agent was installed over Group Policy, the Agent must be uninstalled using the existing Group Policy Object. Otherwise, the Group Policy may detect the Agent as uninstalled and attempt to reinstall it the next time it runs.

If you automatically uninstalled the Agent, using Delete Device on the Dashboard, then Agents installed via Group Policy were removed.

In either the Group Policy Management Console or Active Directory Users and Computers, depending upon the method used to create the policy:

  1. Highlight the required Group Policy Object
  2. Edit to open the Group Policy Editor
  3. Navigate to the location of the MSI
  4. Expand Policies (SBS2008), Software Settings and Software Installation
  5. Right-click the Package in the main Window
  6. Click All Tasks > Remove
  7. Select Immediately uninstall the software from users and computers
  8. Click OK
  9. Exit out of the Group Policy Editor

To ensure the Agent uninstalls successfully, do not remove or change the permission of the software distribution point to ensure this location is accessible by the Agent uninstaller, for example the directory NetworkInstaller.

If the deployment folder is not accessible, a silent uninstall command may be used to uninstall the Agent.

Silently uninstall the Agent using the Command Line

If the Agent was installed manually or via the Remote Worker, you may need to remove it silently.

If Windows Agent Uninstall Protection is enabled, silent uninstall fails. For more information, see Windows Agent Uninstall Protection.

  1. Login to the device
  2. Open a command prompt (Windows key + r then enter cmd)
  3. Enter the removal command based on the Operating System architecture (32 or 64-bit).
Operating System Command

32-bit

"C:\Program Files\Advanced Monitoring Agent\winagent" /removequiet

or, depending on you Agent installation:

"C:\Program Files\Advanced Monitoring Agent GP\winagent" /removequiet

64-bit

"C:\Program Files (x86)\Advanced Monitoring Agent\winagent" /removequiet

or, depending on you Agent installation:

"C:\Program Files (x86)\Advanced Monitoring Agent GP\winagent" /removequiet