Remote Monitoring & Management Help

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 add a script via the Dashboard

  1. Settings > Script Manager
  2. Select New
  3. Populate the below sections in the Add User Defined Scripts dialog
  4. Save to store the script
  5. 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.

automtated_task_command_line clip0149

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 (Windows, Linux or Mac) or an Automated Task (Windows or Mac).

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 OS

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_dialog_add

Improved Script argument handling (Windows)

Please be aware that Windows Monitoring Agents 9.12.2 and 9.13.6 introduced improvements to the handling of the script arguments entered in the Script Parameters, Command Line field of the custom Script Check (9.12.2) and Automated Task (9.13.6). With these improvements any specified arguments are passed to the script exactly as they would be if entered directly on the device itself.

Bash Scripts

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

For example:

#!/bin/bash
"Hello world"
exit 0

What do you want to do?