Automate Agents are specialized software components designed to perform automated tasks and manage various aspects of IT operations, often used by Managed Service Providers (MSPs) to enhance efficiency and reliability. These agents can handle routine maintenance, monitor system performance, and execute scheduled tasks, freeing up valuable time for IT staff and ensuring consistent system management.
In today’s IT landscape, where businesses heavily rely on robust technological support, choosing the right MSP is crucial. However, when clients opt for a different MSP or need to cancel services, it can be a challenging process. Properly managing and offboarding Automate Agents is vital in such scenarios to ensure a smooth transition and to maintain a positive relationship with the client. By following the correct procedures for uninstalling and offboarding these agents, you not only avoid potential disruptions but also leave a good impression, demonstrating professionalism and care in handling client transitions.
In this article, we’ll walk through the essential steps to effectively uninstall and offboard Automate Agents, helping you navigate this process with ease and ensuring a seamless experience for both you and your clients.
Preparing to Uninstall Automate Agents
A well-planned approach is essential for a seamless and efficient uninstallation of Automate Agents. By adhering to a structured pre-uninstallation checklist, you can minimize disruptions and safeguard important data and configurations. Follow these crucial steps:
Backup Essential Data and Configurations
Protecting key information, settings, and customizations is vital to prevent data loss during the uninstallation. Backing up ensures you can restore your system if issues arise or if you need to reinstall the agent in the future.
Steps to Follow:
- Data Backup: Identify all data managed by the Automate Agent, such as system logs, user data, and performance metrics. Use reliable backup solutions to create copies of this information.
- Configuration Backup: Document or export configurations, including scheduled tasks, scripts, and other custom settings. Maintain a clear record of these configurations for future reference.
Inform Team Members and Stakeholders
Effective communication helps prevent unexpected disruptions and ensures that everyone is informed about the upcoming changes. Keeping all relevant parties updated facilitates coordination and manages expectations.
Steps to Follow:
- Internal Communication: Notify your IT team and any other relevant staff about the uninstallation schedule and its implications. Provide details on how it might affect their work and any actions they need to take.
- External Communication: If the Automate Agent affects client-facing services, inform clients or external stakeholders about the planned uninstallation. Make them aware of the timeline and any potential impact on their services.
Review and Adjust Permissions
Reviewing permissions and access rights is crucial to prevent unauthorized access or accidental modifications during the uninstallation. Properly managing these permissions ensures a smooth process and prepares you for any future actions or reinstalls.
Steps to Follow:
- Access Review: Check the permissions and access levels associated with the Automate Agent. Verify which users or systems have the authority to interact with or alter the agent.
- Adjust Permissions: Modify permissions if needed to limit access during the uninstallation. Ensure that only authorized personnel can make changes or perform related tasks.
By carefully preparing and following these steps, you can ensure a smooth uninstallation of Automate Agents, minimizing operational impact and effectively managing data and stakeholder expectations.
Methods to Uninstall Automate Agents
- Manual
- Offboarding Scripts
- Custom Automation
Let’s break these down in order of difficulty to accomplish:
Manual Uninstallation Methods
Manual uninstallation involves directly removing Automate Agents from individual machines, typically using a provided uninstaller tool. This method can be effective for small-scale environments but may be impractical for larger setups.
To start with manual uninstallation methods, you can download the uninstaller from ConnectWise’s repository here. Once downloaded, you can run this tool on each machine to remove the Automate Agent.
This approach is most suitable if the business has 5 or fewer machines and you have the ability to remotely access these systems. If you can complete the process within 15-20 minutes, manual uninstallation can be a straightforward solution. However, for environments with more machines, or if the remote access time is significantly longer, manual uninstallation should be considered only as a last resort. In such cases, it’s advisable to use offboarding scripts wherever possible to automate and streamline the process.
If manual uninstallation becomes necessary, consider informing the client with a template email to explain the situation and any potential impacts.
Offboarding Scripts
Offboarding scripts are an efficient way to handle the removal of Automate Agents from multiple systems. These scripts automate the uninstallation process, reducing the manual effort required and ensuring consistency across all machines.
Let’s review the default offboarding script and explore how it works before we get into the pros and cons. By default, the offboarding script performs several key actions:
- Resets Windows Update Settings: It restores the Windows update settings to their default state, ensuring that no custom configurations are left behind.
- Uninstalls ConnectWise Control: The script removes the ConnectWise Control application, which is often used in conjunction with Automate Agents.
- Queues the Uninstall of the Automate Agent: It schedules the Automate Agent for uninstallation, streamlining the removal process.
- Moves the Agent to the Retired Assets Tab: Finally, it updates the status of the agent to “retired,” indicating that it is no longer active.
However, there are some caveats to be aware of: The offboarding script does not uninstall or remove any third-party software that may be present on the system, nor does it delete sessions in ConnectWise Control. Additionally, the retirement of the agent may fail if the script is not marked for ‘offline agent,’ potentially leading to errors before the agent is successfully retired.
While offboarding scripts are a powerful tool, they may require additional steps to fully remove all components of your MSP stack from the agent. Running the script manually can help address any remaining issues, but be prepared to take extra actions to ensure a complete and thorough offboarding process.

Custom Automation for Offboarding
Custom automation is crucial when you need to address specific requirements that go beyond what the default offboarding script can handle. This approach allows you to tailor the uninstallation process to fit unique needs and ensure that all elements of your system are properly managed.
Custom Automation comes into play here for anything you’ve done outside of the default offboarding script. For instance, ProVal has developed a custom script that interacts with ConnectWise Control. During the uninstall phase, this script not only removes ConnectWise Control from the endpoint but also ends any active sessions in ConnectWise Control, helping to keep your environment clean and organized.
You can take the default offboarding script as a template and modify it to fit your specific needs. This includes adding logic to uninstall additional components of your MSP stack or handling other custom requirements. However, be mindful of certain challenges:
- Uninstallation of Third-Party Software: Some antivirus (AV) and anti-malware programs may not have straightforward uninstallation methods outside of their proprietary tools. Your custom script may need to account for these exceptions.
- Fail-Safes and Alerts: Incorporate fail-safes in your custom script to handle errors effectively. Set up alerts or create tickets if the script encounters issues, particularly if it fails before completing the final uninstallation. This approach promptly addresses any problems, preventing incomplete removal of the Automate Agent.
By customizing your offboarding automation, you can achieve a more comprehensive and controlled uninstallation process, tailored to the specific needs of your environment. This not only improves efficiency but also helps maintain a clean and well-managed IT infrastructure.
Documenting Your Offboarding Process
Proper documentation of your offboarding process is crucial for a smooth transition when clients leave your services. A clear, documented procedure ensures consistency, enhances efficiency, and minimizes errors.
To effectively manage offboarding, create a comprehensive checklist that includes every step from script execution to final system checks. Ensure your team can easily access and use this detailed checklist.
Here’s how to document and manage your offboarding process efficiently:
- Develop a Checklist: Outline all steps, including notifications, data backup, and system verifications. Include both automated and manual tasks.
- Use PSA or Project Management Tools: Integrate your checklist into Professional Services Automation (PSA) or Project Management software to automate tasks, track progress, and ensure completion.
- Assign Responsibilities: Clearly define roles and delegate tasks to appropriate team members to cover all aspects of the process.
- Appoint a Central Overseer: Designate a person or team to monitor progress, address issues, and ensure adherence to the documented process.
- Update Regularly: Review and revise your documentation as needed to reflect any changes in procedures or client needs.
A well-documented and automated offboarding process ensures a structured client transition, reducing errors and enhancing efficiency. This approach demonstrates professionalism and improves client relationship management.
How ProVal Can Assist You With Offboarding Automate Agents
ProVal’s team of engineers and consultants is adept at streamlining your offboarding process to ensure maximum efficiency. We understand that clients often have unique requirements and time constraints, and we’re here to automate and manage these processes for you.
Our expertise includes designing offboarding solutions that meet specific needs, such as scheduling scripts or implementing monitoring systems that automatically handle machine deactivations based on predefined criteria. We have established numerous offboarding methods, from automated script executions to real-time monitoring solutions. We can tailor our approach to meet your precise requirements, making the offboarding process seamless and effective.
Written by: Alex Ramsbey – Business Operations Consultant