Script Check

To monitor your Windows servers and workstations, you can add system default script checks, or your own user defined script checks, to the devices. When you add a script check to devices, you configure the parameter values you require.

Before you can add a user defined script check to a device, the script must be uploaded to the N-sight RMM Dashboard. For instructions to upload a user defined script check, see Add a script to Script Manager.

You can suppress check alerts until the Check failures exceed a configured number of consecutive failures. For more information, see Configure alert thresholds to suppress alerts.

Check configuration

Add a script check to a device

  1. On the N-sight RMM Dashboard, select the device in the North-pane
  2. Go to the Checks tab in the South-pane
  3. Select Add Check and the check frequency — Add 24x7 Check or Add DSC Check

  4. Select Script Check

  5. Select the target script and click Next

    Scripts are grouped by default script categories (if applicable) and User Defined Scripts depending on the Operating system. You can search for a target script, and select a script to view its description.

  6. Configure any Script Parameters settings, including the Command Line for custom scripts (if required)

    To prevent the removal of the leading 0 in arguments, any part of the command that begins with 0 is wrapped in \ so the full argument is preserved when executed or processed.

  7. Enter the Script timeout period in seconds
  8. To Run an Automated Task when a check fails, select Assign a Task after creating the Check
  9. Click Finish to save and apply
  10. If you selected Assign a Task after creating the Check:
    1. Select the Automated Task script and select Next to configure. The following example is for Windows Automated Tasks. Other task options display for Linux and macOS devices.

    2. Enter any required Command Line parameters or Script parameters and select Next
    3. Set maximum permitted execution time for the script (optional)
    4. Select Finish to save and apply

Edit

Script Check - Endpoint Detection & Response cannot be edited and can only be removed by uninstalling EDR from the device.

  1. On the N-sight RMM Dashboard North-pane, select the device
  2. Go to the Checks tab in the South-pane
  3. Right-click the target Script Check and select Edit Check
  4. Edit the script details and parameters
  5. Select OK to save and apply

Delete

  1. On the N-sight RMM Dashboard North-pane, select the device
  2. Go to the Checks tab in the South-pane
  3. Right-click the target check and select Delete Check
  4. Enter the password you used to sign into N-sight RMM to confirm removal
  5. Select OK to delete

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.

We provide the mechanism to run your own scripts on your servers and workstations; however, we are not responsible for custom scripts made or used in conjunction with this product. We are not liable for loss incurred from system, hardware or data loss. It is the customer/developer's responsibility to verify the integrity, actions and impact of any custom scripts.

Windows Agent - Test Check

Although you cannot add or edit a Script Check on the Agent, you can run the script. After the check is synchronized, go to the Script Check tab under the DSC section, highlight the required script and select Test Check.  The Agent also contains information on the Script Check including the script Description, test parameter Arguments, the script Language and Time Out period.

What do you want to do?