PowerShell Scripting

PowerShell Scripting enables you to create custom performance monitors using Windows PowerShell.

Important: WhatsUp Gold uses a 32-bit (i.e. x86) PowerShell engine. Therefore, only 32-bit PowerShell snap-ins are supported and 64-bit only snap-ins will not function properly. Snap-ins usable in both 32-bit and 64-bit operating systems are configured for 64-bit systems by default and must be manually configured for 32-bit PowerShell engine to function properly with WhatsUp Gold.

The PowerShell Scripting performance monitor requires the following credential:

Configure the PowerShell Scripting performance monitor using the following boxes:

To configure an SNMP PowerShell Scripting performance monitor:

  1. Click WUG17.1-PLUS-SP1-Add Recurring Maintenance from the Powershell Scripting Performance Monitor dialog to add a new variable to the Reference variables field. The Add New Reference Variable dialog appears.
  2. Enter the appropriate information:
    • Variable name. Enter a unique name for the variable.
    • Description. (Optional) Enter a short description for the variable.
  3. Select the SNMP radio button.
  4. Enter the Timeout and Retries count for connection to the device. These are optional field entries.
  5. Click Select to launch the MIB Browser.
  6. Enter the name or IP address of the computer you are you are trying to connect to in the Select counters from computer box. You can click browse (...) to select a device from a list.
  7. Select the SNMP Credential used to connect to the device. You can also click browse (...) to access the Credentials Library to create a new credential.
  8. Adjust the length of time and the number of retries for the computer you are trying to connect to in the Timeout and Number of retries boxes.
  9. Click OK.
  10. Use the navigation tree to select the specific MIB you want to monitor. You can view more information about the property/value at the bottom of the dialog.
  11. Click OK to add the OID to the Performance counter and Instance fields in the Add New Reference Variable dialog.
  12. Verify the configuration and click OK to add the variable to the Reference variables list in the Powershell Scripting Performance Monitor dialog.
  13. Write or paste your monitor code in the Script text field.
  14. Click OK to save changes.

To configure a WMI PowerShell Scripting performance monitor:

  1. Click WUG17.1-PLUS-SP1-Add Recurring Maintenance from the Powershell Scripting Performance Monitor dialog to add a new variable to the Reference variables field. The Add New Reference Variable dialog appears.
  2. Enter the appropriate information:
    • Variable name. Enter a unique name for the variable.
    • Description. (Optional) Enter a short description for the variable.
  3. Select the WMI radio button.
  4. Click Select to launch the MIB Browser.
  5. Enter the name or IP address of the computer you are you are trying to connect to in the Select counters from computer box. You can click browse (...) to select a device from a list.
  6. Select the Windows Credential used to connect to the device. You can also click browse (...) to access the Credentials Library to create a new credential.
  7. Click OK.
  8. Use the navigation tree to select the specific MIB you want to monitor. You can view more information about the property/value at the bottom of the dialog.
  9. Click OK to add the OID to the Performance counter and Instance fields in the Add New Reference Variable dialog.
  10. Verify the configuration and click OK to add the variable to the Reference variables list in the Powershell Scripting Performance Monitor dialog.
  11. Write or paste your monitor code in the Script text field.
  12. Click OK to save changes.

See Also

Performance Monitors

Active Script (Performance)

APC UPS (Performance)

AWS CloudWatch (Performance)

Azure Cloud (Performance)

Azure Cloud (Billing and Usage)

CPU Utilization (Performance)

Disk Utilization (Performance)

Printer Ink/Toner Performance Monitor

Hyper-V Virtual Machine Disk Activity

JMX (Performance)

Interface Utilization

Memory Utilization (Performance)

Ping Latency and Availability

REST API (Performance)

SNMP (Performance)

SQL Query (Performance)

SSH (Performance)

VMware Datastore IOPS

Windows Performance Counter

Configuring WMI Formatted Counter monitors

WMI Performance Monitor

Hyper-V Event Log Monitor

Hyper-V Host Virtual Machines Monitor