In this article

These commands can be useful during initial deployment, troubleshooting issues, scripting, or getting some help from our Support team.

Check out the Windows Roaming Client troubleshooting article to see other Windows agent issue resolutions. 

Install Windows Roaming Client

PowerShell

• mkdir C:\temp
  Invoke-WebRequest -Uri "https://download.dnsfilter.com/User_Agent/Windows/DNSFilter_Agent_Setup.msi" -OutFile "C:\temp\DNSFilter_Agent_Setup.msi"
  msiexec /qn /i "C:\temp\DNSFilter_Agent_Setup.msi" NKEY="SITESECRETKEY"

• mkdir C:\temp
  Invoke-WebRequest -Uri "https://download.dnsfilter.com/User_Agent/Windows/DNS_Agent_Setup.msi" -OutFile "C:\temp\DNS_Agent_Setup.msi"
  msiexec /qn /i "C:\temp\DNS_Agent_Setup.msi" NKEY="SITESECRETKEY"

Command Line

• msiexec /qn /i "C:\path\to\DNSFilter_Agent_Setup.msi" NKEY="SITESECRETKEY"

• msiexec /qn /i "C:\path\to\DNS_Agent_Setup.msi" NKEY="SITESECRETKEY"

Start, Stop, or Check service

• SC START "DNSFilter Agent"
  SC STOP "DNSFilter Agent"
  SC QUERY "DNSFilter Agent"

• SC START "DNS Agent"
  SC STOP "DNS Agent"
  SC QUERY "DNS Agent"

Uninstall Windows Roaming Client

PowerShell

• $Prod = Get-WMIObject -Classname Win32_Product | Where-Object Name -Match 'DNSFilter Agent'
  $Prod.UnInstall()

• $Prod = Get-WMIObject -Classname Win32_Product | Where-Object Name -Match 'DNS Agent'
  $Prod.UnInstall()

Command Line

• wmic product where "name='DNSFilter Agent'" call uninstall

• wmic product where "name='DNS Agent'" call uninstall

VPN

This example uses a PANGP adapter, so edit the PANGP value in the command for other adapters. The script automatically recognizes the interface value.

$interfaceName = get-wmiobject win32_networkadapter | Select-Object netconnectionid, name | Where-Object { ($_.name -like 'PANGP*') } | Select-Object -ExpandProperty netconnectionid

$path = 'HKLM:\SOFTWARE\DNSFilter\Agent'

Set-ItemProperty -Path $path -Name 'IgnoreVpnInterfacesNames' -Value $interfaceName

Set-ItemProperty -Path $path -Name 'IgnoreVpnInterfaces' -Value 'true'

Restart-Service -Name 'DNSFilter Agent'

Port Binding

Determines what other applications might be listening or bound to port 53--the port the agent needs to bind to for filtering.

netstat -ban | findstr :53

DNS-over-TLS

• reg add "HKLM\Software\DNSFilter\Agent" /v UpstreamOrder /d "tcp-tls,udp,tcp" /f

• reg add "HKLM\Software\DNSAgent\Agent" /v UpstreamOrder /d "tcp-tls,udp,tcp" /f