Adding a PowerShell Execution Check component

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 Execution component allows you to run a PowerShell script and analyze the output. You may add a PowerShell Execution component to an application profile or an application instance.

Note: Adding components to an application profile helps create the foundation of the application profile. After adding components to an application profile, you must create an instance to monitor a device. Learn more about APM terminology.

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 PowerShell Execution component to an application profile:

1. From the WhatsUp Gold web interface, go to APM > Configuration. The All Application Profiles page appears.
2. Select the application profile for which you want to add a component, then click Edit/View Application Profile. The Components list appears.
3. Click Add Components. The Component Library appears.
4. Click the arrow next to Scripting to expand the dialog controls used to add the component(s).
5. Specify the number of components you want to add by clicking the up and down arrows next to PowerShell.
6. Click Add Selected.
7. Click browse (...) next to the TEST Device box to launch the Select a Device dialog.

   

8. Select a device from the navigation tree on which to test the individual component and click OK.
9. Click Test to test the component on the selected device (optional). To remove the device override and revert to the device associated with the application component, click .

   Note: If no test device is selected, the component is tested on the test device associated with the application profile.

   Test devices are not saved as part of the application profile.

10. Enter or select the appropriate information in the PowerShell Execution component boxes.
11. Click Save to save your changes or click Save and Close to complete your changes.

To add a PowerShell Execution component to an application instance:

1. From the WhatsUp Gold web interface, go to APM > Configuration. The All Application Profiles page appears.
2. Select the application instance for which you want to add a component.
3. Click Add Components. The Component Library appears.
4. Click the arrow next to Scripting, then specify the number of components you want to add by clicking the up and down arrows next to PowerShell.
5. Click Add Selected.
6. Enter or select the appropriate information:
   • Enabled. Select this option to enable or disable the component.
   • Action Policy. Select an action policy from the list for the component.
   • Device Override. (Optional) Override the device associated with the instance and designate a specific device to assign to the component.
     • Click browse (...) next to the Device Override box to launch the Select a Device dialog.

       Important: If the device you want to use is configured with a WhatsUp Gold down dependency, make sure that you use a cloned device for this device selection in the APM plug-in. For more information, see the Dependencies overview.

     • Select a device from the navigation tree on which to test the individual component and click OK.
     • Click Test to test the component on the selected device.

   Note: Click to remove the device override and revert to the device associated with the application instance.

7. Enter or select the appropriate information in the PowerShell Execution component boxes.
8. Click Save to save your changes or click Save and Close to complete your changes.

See Also Working with components Adding components to an application instance Testing components Adding a CPU Utilization component Adding a MySQL Query component Adding an Oracle Query component Adding a SQL Server Query component Adding a Disk Utilization component Adding a Physical Memory Utilization component to an application profile Adding a Virtual Memory Utilization component Adding a Custom Port Check component Adding an Echo Port Check component Adding an FTP Port Check component Adding an HTTP Port Check component Adding an HTTPS Port Check component Adding an IMAP4 Port Check component Adding an NNTP Port Check component Adding a POP3 Port Check component Adding a Radius Port Check component to an application profile Adding an SMTP Port Check component Adding a Time Port Check component Adding an SNMP Process Check component Adding a WMI Process Check component Adding a JavaScript Execution Check component Adding an End User Monitoring component Adding a VBScript Execution Check component Adding an SNMP Service Check component Adding a WMI Service Check component Adding an SNMP Check component Adding an SSH Active Monitor Check component Adding an SSH Performance Monitor Check component Adding a WMI Formatted Counter Check component Adding a WMI Raw Counter Check component