Upload the Script

When logged on to the Dashboard as a user with enhanced privileges for example a Superuser or (non-Classic) Administrator level account, a login with the required Custom Scripts permissions enabled or the Agent Key (where Dashboard access is enabled) you can upload a script via Settings, Script Manager.

To ensure a shell script runs successfully, declare the bash interpreter in the script: #!/bin/bash. For example:

"Hello world"
exit 0

To add a script via the Dashboard

  1. Go to Settings > Script Manager
  2. Select New
  3. Populate the below sections in the Add User Defined Scripts dialog
  4. Click Save to store the script
  5. Choose Close to exit out of the Script Manager
Section Notes
Name Provide a descriptive name to enable easy identification of the script on the Dashboard and Reports.
Usage Notes Contains the information displayed in the Test Parameters section when adding or editing the Script Check or Automated Task. This section may be also be used to provide additional detail on the script's function or an example of the command line parameters to ensure any user can correctly configure the script and Command Line parameters when adding or editing the Script Check or Automated Task.
Default Timeout Period in seconds can also be entered. Where this is exceeded the Agent stops the script and it is reported as failed.
Type Choose how the script will run, as a Script Check or an Automated Task

Automated Tasks are supported for Windows, Mac (from Agent 2.3.0), and Linux (from Agent 2).

OS The Operating System the script is designed to run on, where selected the script will only be selectable for devices running this Operating System. The options are Windows, Linux and Mac
Upload a script The script itself is added by selecting the Browse button in the File Upload field. Simply navigate to the location of the script and upload it to the Dashboard where it is downloaded to the selected machines.


Supported script size: up to a maximum of 65535 characters
Supported script output size: up to a maximum of 10000 character

Script argument handling (Windows)

For the Windows Agent, script arguments entered in the Script Parameters, Command Line field of the custom Script Check and Automated Task dialog are passed to the script exactly as they would be if entered directly on the device itself.

What do you want to do?