Adding and editing a PowerShell active monitor

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 active monitor provides a platform for performing a wide variety of monitoring tasks through direct access to script component libraries, including the .NET Framework. For more information, see PowerShell active monitor script examples.

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.

If you are using additional pollers with WhatsUp Gold, PowerShell must be installed and any desired snap-ins must be registered identically on all poller machines for any PowerShell performance monitors, active monitors, and actions to function properly. Associated errors resulting from failed monitors will appear in the WhatsUp Gold Status Center. Errors resulting from failed actions will appear in the WhatsUp Gold Event Viewer.

Note: This feature is available with WhatsUp Gold Premium, ProView, TotalView, and TotalView Plus Editions only. To update your license, visit the WhatsUp Customer Portal.

To add a new PowerShell active monitor:

1. From the WhatsUp Gold web interface, go to Admin > Monitors. The Monitor Library dialog appears.
2. Click the Active tab. The Active Monitor list appears.
3. Click New. The Select Active Monitor Type dialog appears.
4. Select PowerShell Active Monitor, then click OK. The Add PowerShell Active Monitor dialog appears.
5. Enter or select the appropriate information:
   • Name. Enter a unique name for the active monitor. This name displays in the Active Monitor Library.
   • Description. (Optional) Enter additional information about the monitor. This description displays next to the monitor in the Active Monitor Library.
   • Timeout (Seconds). 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 SMTP server. This is considered a failed connection.

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

   • Run under device credentials. Select this check box to execute the script using the Windows credentials for the affected device. For additional information, see Using the Credentials Library.
   • Script text. Enter your monitor code here.
6. Click OK to save changes.
7. After configuring an active monitor in the Active Monitor Library, add the monitor to devices.

To edit an existing PowerShell active monitor:

1. From the WhatsUp Gold web interface, go to Admin > Monitors. The Monitor Library dialog appears.
2. Click the Active tab. The Active Monitor list appears.
3. Select the monitor you would like to edit, then click Edit. The Edit PowerShell Active Monitor dialog appears.
4. Enter or select the appropriate information:
   • Name. Enter a unique name for the active monitor. This name displays in the Active Monitor Library.
   • Description. (Optional) Enter additional information about the monitor. This description displays next to the monitor in the Active Monitor Library.
   • Timeout (Seconds). 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 SMTP server. This is considered a failed connection.

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

   • Run under device credentials. Select this check box to execute the script using the Windows credentials for the affected device. For additional information, see Using the Credentials Library.
   • Script text. Enter your monitor code here.
5. Click OK to save changes.

See Also Using Premium active monitors Adding and editing an APC UPS Monitor Monitoring mail servers Monitoring Microsoft Exchange 2003 servers Monitoring a Microsoft Exchange Server Adding and editing a Fan Monitor Adding and editing a File Content monitor Adding and editing a File Properties monitor Adding and editing a Folder Monitor Adding and editing an FTP Monitor Adding and editing an HTTP Content Monitor Adding and editing a JMX active monitor Adding and editing a Network Statistics Monitor Adding and editing a Printer Monitor Adding and editing a Process Monitor Adding and editing a SQL Query active monitor Adding and editing a SQL Server 2000 monitor Adding and editing an SSL Certificate monitor Adding and editing a Temperature Monitor Adding and editing a VoIP Monitor Adding and editing a WMI Formatted active monitor Adding and Editing a WMI Monitor Assigning active monitors Removing and deleting active monitors About critical active monitors Group and Device active monitor reports