Skip to main content

ScreenConnect Client - Connectivity - Audit

Summary

This script will return a variable (@Online@) as 0, 1, -2, -3, or -4.

  • 0: Offline
  • 1: Determining if the target machine is online in Control
  • -2: The CW RMM+ Plugin Configuration is broken in the environment
  • -3: The Machine Error can be anything
  • -4: The Agent GUID was not set appropriately to 32 characters excluding the (-) lengths, i.e., 4.

An email will be sent to Alerts@provaltech.com if the RMMPlus solution is not properly configured.

Subject: Incorrect RMM_Plus Configuration - %redirhostname%

Body:

RMM_Plus is not properly configured for %redirhostname%. Please get this fixed as soon as you can.
Reference: /docs/f99ddaae-0cb3-4941-b2aa-dc93671dd246

Time Saved by Automation: 10 Minutes

Sample Run

Sample Run

Dependencies

CW RMM+ Plugin Configuration

System Properties

NameExampleRequiredDescription
RMMPlus_AccessKeyabc4cudf2er$%TrueThis will be the access key that is set in the RMM+ extension on the Control server.
RMMPlus_Timeout1000TrueThe command timeout. The ProVal standard is to set this to 1000.
RMMPlus_Headerslabtech.provaltech.comTrueOrigin: automate.yourserver.com
RMMPlus_IsBroken1FalseScript will set this property to ensure that it does not send another email to alerts@provaltech.com for the improperly configured RMM+ solution.

Script States

NameExampleDescription
OnlineInScreenConnectSinceMinutessession not found, 12234, -1213Outcome of the plugin result. Usually the time in minutes for which the computer is online in ScreenConnect. (-ve time indicates that the machine is offline for that many minutes). This state is further used as the "Command Result" column of CWM - Automate - Dataview - Agent - Agent Check-in Health dataview.

Output

  • Script log
  • Script state
  • Email