Deploying Roaming client via RMM tools
Table of Contents
Deploying Roaming Client or Agent via RMM Tools
This article provides step-by-step instructions for deploying the Cyber Fox DNS roaming client or agent using Remote Monitoring and Management (RMM) or other deployment tools. Follow these guidelines to ensure a smooth and efficient deployment process.
Download the Latest Client
Download the latest client from the following link:
- A Generic Installer that you will supply the location key via the command line: Generic Installer
- The Specific installer that you download from the company, location, or device on the portal that should look like:
cyberfox-dns-[locationkeyhere].exe
Location Specific Installers
If you are downloading the location-specific installer, ensure that the executable is downloaded per client site and do not change the name of the executable. The location key in the name will be used to assign it to the correct location without any command line requirements.
Deploy the Generic installer with the command line option.
Use the following command to deploy the client via your RMM tool of choice:
dns-latest.exe /SP- /SUPPRESSMSGBOXES /VERYSILENT /NORESTART /COMPANY_ID=[company id]
Command Line Options Explained
-
/SP-
: Suppresses the “Do you wish to continue?” prompt. -
/SUPPRESSMSGBOXES
: Suppresses message boxes during installation. -
/VERYSILENT
: Eliminates any need for user interaction during the installation process. -
/NORESTART
: Suppresses any need for a restart after the installation is completed. -
/COMPANY_ID=[company id]
: Supply the location company ID to the installer.
If your RMM supports variables, you can insert the company ID as a variable for wider deployments using a single deployment script.
Deploy the Location-Specific installer with the command-line options.
Use the following command to deploy the client via your RMM tool of choice when using the client's location-specific installer file:
cyberfox-dns-[locationkeyhere].exe /SP- /SUPPRESSMSGBOXES /VERYSILENT /NORESTART
Command Line Options Explained
-
/SP-
: Suppresses the “Do you wish to continue?” prompt. -
/SUPPRESSMSGBOXES
: Suppresses message boxes during installation. -
/VERYSILENT
: Eliminates any need for user interaction during the installation process. -
/NORESTART
: Suppresses any need for a restart after the installation is completed.
If you use the location-specific installer without any command line options during deployment, the end user will be prompted with a dialog box to continue the installation. We highly recommend installation using the above command line options to install silently.
Deployment via PowerShell Script (Example)
Here is a PowerShell script that downloads the Cyber Fox DNS client and deploys it using the LocationID
as a variable:
# Define variables
$downloadUrl = "https://cdn.passwordboss.com/dns-client/production/dns-latest.exe"
$companyID = "LocationID"
$downloadPath = "$env:Temp\dns-latest.exe"
# Download the file
Invoke-WebRequest -Uri $downloadUrl -OutFile $downloadPath
# Install the DNS client
Start-Process -FilePath $downloadPath -ArgumentList "/SP- /SUPPRESSMSGBOXES /VERYSILENT /NORESTART /COMPANY_ID=$LocationID" -Wait
# Clean up
Remove-Item $downloadPath
Instructions:
- Replace
LocationID
with the actual Location ID from the Company, Location, or Roaming Device.
- Save the script as a
.ps1
file.
- Run the script on the target machine.
This script will download the latest Cyber Fox DNS client, install it using the specified company ID, and then clean up the downloaded file. You can modify and use this example script in the RMM or deployment tool of your choice.
Deployment via Intune (Example)
To install the Cyber Fox DNS roaming client via Intune, follow these steps:
Step 1: Prepare the Installation Package
- Download the latest client-specific installer that you downloaded from the location on the portal, which should look like:
cyberfox-dns-[locationkeyhere].exe
- Ensure that the executable is downloaded per client site. Do not change the name of the executable.
Step 2: Convert the Executable to .intunewin Format
- Download the Intune Win32 Content Prep Tool from Microsoft and follow the instructions.
- Use the tool to convert the executable file to
.intunewin
format. Run the following command:
IntuneWinAppUtil.exe -c <source_folder> -s cyberfox-dns-[locationkeyhere].exe -o <output_folder>
- The tool will generate a
.intunewin
file in the specified output folder.
Step 3: Create a Win32 App in Intune
- Open the Microsoft Endpoint Manager admin center.
- Navigate to Apps > Windows > Add.
- Select App type as Windows app (Win32).
Step 4: Configure App Information
- Upload the
.intunewin
file. - In the App information section, provide the necessary details such as name, description, publisher, etc.
Step 5: Configure Program
- In the Program section, enter the following install command:
Using the Location Specific installer:
cyberfox-dns-[locationkeyhere].exe /SP- /SUPPRESSMSGBOXES /VERYSILENT /NORESTART
Using the Generic Installer
dns-latest.exe /SP- /SUPPRESSMSGBOXES /VERYSILENT /NORESTART /COMPANY_ID=[company id]
- Enter the uninstall command if needed (e.g.,
cyberfox-dns-[locationkeyhere].exe /uninstall
).
- The rest of the options, the default options, are fine, adjust as needed for your environment.
Step 6: Configure Requirements
- Specify the requirements for app installation, including operating system architecture and the minimum OS version.
Step 7: Configure Detection Rules
- Set up detection rules to ensure the app is installed correctly. You can use the file detection method with the following:
- Rule type: File
- Path: C:\Program Files\CyberFOX DNS Client
- File or folder: client.exe
- Detection Method: File or Folder exists
- Associated with a 32-bit app on a 64-bit Client: No
Step 8: Assign the App
- Assign the app to the required groups or devices.
Step 9: Review and Create
- Review the configuration and create the app.