PowerShell Script Action

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 action delivers a robust and flexible environment to the experienced user for developing custom actions through direct access to script component libraries, including the .NET Framework. For more information, see PowerShell 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 display in the WhatsUp Gold Event Viewer.

Configure the following:

• Name. Enter a unique name for the action. This name displays in the Actions Library.
• Description. Enter a short description about the action. This description displays next to the action in the Actions Library.
• Timeout. 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: You are highly discouraged from using a timeout longer than 10 seconds. Please use the shortest timeout possible.

• Use Device Credentials. Enable this option to execute the script using the Windows credentials for the affected device. For additional information, see Using the Credentials Library.

  Important: If Run under device credentials is enabled, the Test functionality in the WhatsUp Gold Admin Console will not work.

• Script Text. Enter your action code. Additionally, you can use the System, Device, and/or Monitor dropdown menus within the dialog to automatically insert supported variables.

  Important: When using percent variables as part of string literals in your PowerShell scripts, please use double quotation marks (" ") instead of single quotation marks (' ') to enclose the string literal. For example: $Message = "%Device.DisplayName changed state".

See Also Built-in Action Types Active Script Action Beeper Action Configuration Management Action Create ServiceNow Incident Action E-mail Action Log to File Action OpsGenie Alert Management Action Pager Action Post To IFTTT Action Post To MS Teams Action Post To Slack Action Program Action SMS Action SMS Direct action SNMP Set Action SSH Action Service Restart Action Sound Action Syslog action Text to Speech Action Vmware Action Web Alarm Action Windows Event Log Action Select Action and State Select a State Change