Uninstall an access agent
Introduction
This article will explain how to uninstall an access agent via the ConnectWise ScreenConnect™ Host page.
Uninstall vs. Delete
Warning: It is important to note the difference between the Uninstall and Delete commands.
Uninstall
The Uninstall command:
- Removes the access agent from the remote machine
- Removes the service from the remote machine
In most cases, you will only need to use the Uninstall command to remove the agent from a remote device.
Delete
The Delete command acts as a "kill switch" for a machine that is no longer available.
The Delete command:
- Sets the agent service on a remote machine in a disabled state so it cannot be restarted
- Removes the session from the Host page
- Does not remove or uninstall the access client from the remote machine
See our article on how to delete a session for more information.
Uninstalling an access client from the Host page
1. Select an access session on the Host page
2. Click the More icon
3. Select Uninstall from the menu
4. Select Uninstall Only or Uninstall and Delete
Uninstall Only will uninstall the access agent from a machine but leave the machine listed on your Host page.
Uninstall and Delete will uninstall the access agent from a machine and will remove your machine from the list on the Host page.
Select either Uninstall Only or Uninstall and Delete.
5. Click Perform
Click Perform. Your access session will disconnect from your Host page, and the access client will be removed from your remote machine.
Note: If a host is currently connected to an access session, the access agent will be uninstalled when the host has disconnected from the access session.
Tip: You can also right-click on a session and select Uninstall from the right-click menu.
Manually removing the unattended access client
In rare cases, you may instead prefer to manually uninstall the agent.
What's next
To reinstall and upgrade your ScreenConnect agents, see our article on reinstall and upgrade an access agent.