Context

The custom scripts feature allows you to use one of the 5 types of scripts to perform actions on an agent or node that you have previously selected.

To access it, click on the "Action" section of the main menu.

Windows Registry

By choosing this type of script, you can retrieve a value from the registry of a Windows machine.

Settings

The settings are divided into 3 sections: General, Execution Parameters, and Customization.

  • General

You will find fields to name, add a description, define a target by choosing operating system criteria and/or agent type, and you can set an execution frequency. 

The execution frequency will determine how many sliding results you can keep. The maximum number of sliding results saved is 1440. 

Frequency example: 

If I chose a frequency of 5 minutes, the retention of my data has a maximum duration of 5 days (5 minutes x 1440). After 5 days, the first result of my script is deleted.

  • Execution Parameters

pathName:

Define in this field the path to the Windows registry value or key.

valueName:

Specify the name of the Windows registry value.

chooseArchitectures:

Choose from the 5 options the one that best suits the architecture of the machines that will be affected.

- Native agent architecture
- 64-bit architecture only
- 32-bit architecture only
- First read 64-bit architecture data, otherwise 32-bit
- First read 32-bit architecture data, otherwise 64-bit

  • Customization

Here you can define the names of the values returned in the script results for better understanding when reading the results. This also allows you to choose the type and format of the response (text or graphs).

Executing the Script

Before permanently deploying your script on the agent or agents of the selected node, you can add one or more Alerts and Test your script on a specifically chosen agent. 

Once the script meets your expectations, press "Create" to execute the script.