Skip to main content

Install DNSFilter Agent

Summary​

Deploys DNSFilter Agent on both windows and MAC machines.

Sample Run​

Sample Run

Dependencies​

Task Creation​

Script Details​

Step 1​

Navigate to Automation ➞ Tasks
step1

Step 2​

Create a new Script Editor style task by choosing the Script Editor option from the Add dropdown menu
step2

The New Script page will appear on clicking the Script Editor button:
step3

Step 3​

Fill in the following details in the Description section:

  • Name: Install DNSFilter Agent
  • Description: Deploys DNSFilter Agent on both windows and MAC machines.
  • Category: Custom

Image1

Script Editor​

Click the Add Row button in the Script Editor section to start creating the script
AddRow

A blank function will appear:
BlankFunction

Row 1: Set Pre-defined Variable ( @DeploymentKey@ = DNSFilter Deployment Key )​

  • Variable Name: DeploymentKey
  • Type: Custom Field
  • Custom Field: DNSFilter Deployment Key
  • Continue on Failure: True
  • Operating System: Windows,MacOs

Image2

Row 2: PowerShell script​

  • Use Generative AI Assist for script creation: False
  • Expected time of script execution in seconds: 600
  • Continue on Failure: False
  • Run As: System
  • Operating System: Windows
  • PowerShell Script Editor:

PowerShell Script

Image3

Row 3: Bash script​

  • Use Generative AI Assist for script creation: False
  • Expected time of script execution in seconds: 600
  • Continue on Failure: False
  • Run As: System
  • Operating System: MacOs
  • Bash Script Editor:

Bash Script

Image4

Row 7: Script Log​

  • Script Log Message: %Output%
  • Operating System: Windows, MacOs

Image5

Save Task​

Click the Save button at the top-right corner of the screen to save the script.
SaveButton

Completed Task​

Image6

Deployment​

This task has to be scheduled on the DNSFilter Agent Deployment group for auto deployment. The script can also be run manually if required.

  • Go to Automations > Tasks.
  • Search for Install DNSFilter Agent.
  • Then click on Schedule and provide the parameter details as necessary for the script completion.

Target Group: Deployment1

Complete Schedule Task: Deployment2

Output​

  • Script Logs

Changelog​

2026-02-18​

  • Initial version of the document