Huntress Agent (INSTALL)

Summary

Installs the Huntress agent on the Windows machine if it's not already installed.

Dependencies

• Custom Fields - Huntress Acct_Key
• Custom Fields - Huntress Org_Key
• Custom Fields - Huntress Tag
• Custom Fields - Huntress Deploy_Result
• Device Group - Deploy Huntress

Create Script

Please create a new "PowerShell" style script to implement this script.

Name: Huntress Agent Install
Description: This task will check first if Huntress is installed. If not, it attempts to install the agent and log the result.
Category: Custom

Script

Row 1 Function: Script Log

Input the following:

Bash Script 1

Row 2 Function: Set Pre-defined Variable

• Select Set Pre-Defined Variable Function

• Select Custom Field
• Input acct_key as Variable name
• Select Huntress Acct_Key custom field from the drop-down
• Click Save

Row 3 Function: Set Pre-defined Variable

• Select Set Pre-Defined Variable Function

• Select Custom Field
• Input ORG_Key as Variable name
• Select Huntress Org_Key custom field from the drop-down
• Click Save

Row 4 Function: Set Pre-defined Variable

• Select Set Pre-Defined Variable Function

• Select Custom Field
• Input Tags as Variable name
• Select Huntress Tag custom field from the drop-down
• Click Save

Row 5 Function: PowerShell Script

Paste in the following PowerShell script and set the expected script execution time to 1500 seconds.

PowerShell Script

Step 6 Function: Script Log

• Add a new row in the If Section of the If-Else part by clicking the Add Row button
• Search and select the Script Log function.
• Input the following

Bash Script 2

Step 7 Logic: If Then Else

• Add a new If/Then/Else logic from the Add Logic dropdown menu.

ROW 7a Condition: Output Contains

• Type Huntress agent is installed in the Value box.

ROW 7b Function: Set Custom Field

• Add a new row in the If Section of the If-Else part by clicking the Add Row button
• Search and select the Set Custom Field function.

• Search and select the Huntress Deploy_Result Custom Field.
• Type Successfully Installed in the Value box and click the Save button.

ROW 7c Function: Script Log

• Add a new row in the If Section of the If-Else part by clicking the Add Row button
• Search and select the Script Exit function.
• Leave it blank

Bash Script 3

ROW 7d Function: Script Exit

• Add a new row in the If Section of the If-Else part by clicking the Add Row button
• Search and select the Script Exit function.
• Leave it blank

Step 7e Logic: If/Then

Add a new If/Then logic from the Add Logic dropdown menu inside the Else section.

Row 7e(i) Condition: Output Contains

• Select Output from the drop-down
• Type ERROR: in the Value box.
• Select another condition with the OR Operator
• Type Account Key Missing in the Value box.

Row 7e(ii) Function: Set Custom Field

Add another row by selecting the ADD ROW button in the Else section of the internal If/Then section.

• Search and select the Set Custom Field function.

• Search and select the Huntress Deploy_Result Custom Field.
• Type %Output% in the Value box and click the Save button.

Row 7e(iii) Function: Script Exit

Add another row by selecting the ADD ROW button in the Else section of the internal If/Then section.

• Search and select the Script Exit function.
• Input the following

Bash Script 4

The final task should look like the screenshot below.

Script Deployment

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

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

Output

• Script log

FAQ

Note:
For the Huntress deployment, the Huntress_Acct_Key is mandatory to be filled at the company level.

The other custom fields can be left blank.

Note:
Huntress_Acct_Key and Huntress_Org_Key are the company custom fields, whereas the Huntress_Tags is the site-level custom field.

Changelog

2025-04-10

• Initial version of the document