In this article

Users with admins permissions or higher use this article to uninstall the Windows Roaming Client version 2.0.1 or higher.

As of Windows Roaming Client version 2.0.1, admins can uninstall the agent directly from the DNSFilter dashboard. We've also built-in a backup manual uninstall method that requires a PIN generated from the dashboard. This way end-users that want to uninstall the agent from their local device can request the PIN from admins to complete the process.

The download and installation for this version follow our standard methods.

Prerequisites

• Only available for x64 builds and requires .net 4.8.0 or higher

• Users must be running Windows agent version 2.0.1 or higher

• Version 2.0.1+ will no longer show up in the local device's Add/Remove Programs list

Uninstall from the DNSFilter dashboard

Follow these steps to complete the uninstall.

1. Navigate to the Roaming Clients Manage tab in the dashboard

2. From the Actions menu, select the Trash icon

   1. To uninstall multiple agents at once:

      1. Check the box next to the Client Name of each agent

      2. Select Delete

3. Select Uninstall & Delete

The Roaming Client(s) will move to a Pending Uninstall status, which saves the uninstall configuration to the server. The next time the agent checks in, it retrieves and executes the uninstall, which is typically within five minutes.

✍️ This process can take longer when an agent is offline: in these instances the agent stays in Pending  Uninstall status until it wakes up and checks in with the dashboard.

The Roaming Client will no longer show up in the dashboard when the uninstall is complete.

What happens if I try to uninstall a Roaming Client version that isn’t supported by this update?

The Roaming Client dashboard will only issue the uninstall command to supported agent versions. If supported and unsupported versions are selected, the dashboard will deliver a warning that the unsupported agents will be removed but not uninstalled and create two lists for review:

• Roaming Clients that will be uninstalled & deleted (remote uninstall is supported)

• Roaming Clients that will be deleted (remote uninstall is not supported)

Uninstall manually

Use these steps if the dashboard uninstall did not work or a scripted/GPO/RMM uninstall configuration is preferred for your environment.  

1. Navigate to the Roaming Client Uninstall tab and copy the Uninstall PIN 

2. Copy the GUID from this registry key:

   Computer\HKEY_LOCAL_MACHINE\SOFTWARE\DNSFilter\Agent

3. Insert the PIN and GUID into this prompt and run it from an administrator command prompt:

   msiexec /X{GUIDHERE} UPIN=PINFROMDASHBOARDHERE REGCLEAN=true/false (to remove and cleanup registry or not)

The Roaming Client will be uninstalled once the command run finishes.