Creating device-specific PowerShell Scripting performance monitors

Windows PowerShell is a scripting language and command-line shell that system administrators can use to manage Windows operating systems. For more information on PowerShell, please visit the Microsoft web site.

The PowerShell Scripting performance monitor allows the experienced user to perform a wide variety of monitoring tasks through direct access to script component libraries, including the .NET Framework. The Windows PowerShell scripting language can be used in conjunction with WhatsUp Gold to help you monitor, control, manage, and automate Windows operating system activities. For example, you might implement a script to look for a process and report the current number of threads in the process. Or, you might implement a script to look for idle time levels and log the results. For more information and examples of PowerShell performance monitors, see Example - PowerShell performance monitor scripts.

Note: This feature is available with WhatsUp Gold Premium Edition only. To update your license, visit the WhatsUp Customer Portal.

To create a device-specific PowerShell Scripting performance monitor:

1. From the WhatsUp Gold web interface, right-click a device, then click Properties. The Device Properties dialog appears.
2. Click Performance Monitors. The Performance Monitors information appears.
3. Click Add. The Select Performance Monitor Type dialog appears.
4. Select PowerShell Scripting Monitor, then click OK. The Add PowerShell Performance Monitor dialog appears.
5. Enter or select the appropriate information:
   • Name. Enter a unique name for the performance monitor. This name displays in the Performance Monitor Library.
   • Description. (Optional) Enter additional information about the monitor. This description displays next to the monitor in the Performance Monitor Library.
   • Timeout (sec). Enter the length of time WhatsUp Gold attempts to connect to the selected device. When the time you enter is exceeded without connecting, a timeout occurs and WhatsUp Gold stops trying to connect to the device. This is considered a failed connection.

   Note: Although the default timeout is 60 seconds, you are highly discouraged from using a timeout longer than 10 seconds. Please use the shortest timeout possible.

   • Collection interval (min). The amount of time between performance polls.
   • Reference variables. Add, edit, or remove SNMP and WMI reference variables using the respective buttons.
   • Script text. Enter your code here.
6. Click OK to save changes.
7. Click OK to exit the Device Properties dialog.

See Also Creating custom performance monitors Creating device-specific Active Script performance monitors Creating device-specific APC UPS performance monitors Example - PowerShell performance monitor scripts Creating device-specific SNMP performance monitors Creating device-specific Printer performance monitors Creating device-specific SQL Query performance monitors SQL Query Builder Creating device-specific SSH performance monitors Creating device-specific WMI Formatted Counter performance monitors Creating device-specific WMI performance monitors Example: monitoring router bandwidth Example: troubleshooting a slow network connection