Adding a PowerShell Script action

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 action 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.

To add a new PowerShell script action:

1. From the WhatsUp Gold web interface, go to APM > Actions, then click Actions in the Actions Management tree. The Actions page appears.
2. Click Add Action. The Edit Action page appears.
3. Select PowerShell Script from the Action type list. The boxes for the PowerShell Script action appear.
4. Enter or select the appropriate information:
   • Name. Enter a unique name for the action. This name displays in the Action Library.
   • Description. (Optional) Enter additional information about the action. This description displays next to the action in the Action 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 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. 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 action code.
5. Click Save. The PowerShell Script action is added to the actions list.

See Also Creating an action in APM Adding an Active Script action Adding an E-mail action Adding a Log-to-Text File action Adding a Windows Event Log action Adding a Program action Adding a Service Restart action Adding an SMS action Adding an SMS Direct action Adding an SSH action Adding a Syslog action Adding a VMware action