Skip to main content

How can we help you?

Search

help Knowledge Base
forum Community
checklist Release Notes
event Events

Uninstall Windows Roaming Client v2.0.1 or higher

Minetta Gould
  • Updated

    In this article

Users with admins permissions or higher use this article to uninstall Windows Roaming Client beta version 2.0.1+ directly from the DNSFilter dashboard. The download and installation for this version follow our standard methods.

Beta release best practice

As a friendly reminder, DNSFilter offers beta versions of upcoming production candidates to allow organizations to test new features and functionality ahead of a production release. It’s advised to only test beta versions in a specific subset of endpoints in the field, as changes to the beta version prior to production release are likely to occur.

What’s Changed

Admins can uninstall the agent directly from the DNSFilter dashboard.

Prerequisites

  • Only available for x64 builds and requires .net 4.8.0+

  • Users must be running Windows agent version 2.0.1+

Uninstall from the DNSFilter dashboard

Follow these steps to complete the uninstall.

  1. Navigate to the Roaming Clients 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)

WinRC Uninstall .png

Uninstall manually

Use these steps if the dashboard uninstall did not work or a scripted/GPO/RMM uninstall configuration is preferred for your environment. Temporarily modify existing automations to include the uninstall PIN and pass that variable through the msiexec script.

✍️ The GUID unique to the Organization, not the user account.

  1.  Copy the GUID from this registry key:

    • Computer\HKEY_LOCAL_MACHINE\SOFTWARE\DNSFilter\Agent
    • Computer\HKEY_LOCAL_MACHINE\SOFTWARE\DNSAgent\Agent

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

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

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

If an error occurs during the uninstall process, re-run the commands with these edits to create a log file. Our Support team can review these files to investigate the issue. 

msiexec /X{GUIDHERE} REGCLEAN=true/false (to remove and cleanup registry or not) /L*vx! FOLDERANDLOGFILE (eq: C:\Temp\dns_agent_uninstall.log)

Comments

2 comments

Date Votes
  • Christopher Harris

    Not sure if this was just because my test machine was in the MSP/WhiteLabel/beta track (v2.0.3 at the time of this comment), but my registry key for the GUID (manual uninstall method) was actually in Computer\HKEY_LOCAL_MACHINE\SOFTWARE\DNSAgent\Agent not \SOFTWARE\DNSFilter\Agent. I got the right GUID by running the powershell command Get-WMIObject -Classname Win32_Product | Where-Object Name -Match ‘DNS Agent’ that I got from the “Uninstall Windows Roaming Client v1.15.3 and older” page :)

    0
  • Minetta Gould Community Team DNSFilter Staff

    Hi Christopher Harris , thanks for the callout! We missed adding the whitelabel registry key to this guide, but got it all fixed up. Nice work finding it in the other article, and thanks for your help in improving our content! 

    0

Please sign in to leave a comment.