Scripting (PowerShell)

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

Important: Network Performance Monitor 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 Network Performance Monitor.

If you are using additional pollers with Network Performance Monitor, 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.

Configure the following:

Name. Enter a unique name for the component.
Description. Enter additional information about the component.
Critical. Click to select this check box if the component is critical.

Note: Components specified as critical cause the application to go into a down state when the component is out of threshold. Non-critical components cause the application to go into a warning state. For more information on application states, see Working with application states.

Polling frequency. Select a time (in minutes or hours) you want APM to wait between polls.
Script timeout. Enter the length of time APM attempts to connect to the selected device. When the time you enter is exceeded without connecting, a timeout occurs and APM stops trying to connect to the device. This is considered a failed connection.
Add a Reference Variable. Click to open the Reference Variable dialog and add a reference variable to the component.
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 to Run. Enter your script to return a single, numeric value.
Warning threshold. Enter the component thresholds for the warning state. For example, if the component value is greater than 90 for 5 minutes, put the component in the warning state.
Down threshold. Enter the component thresholds for the down state. For example, if the component value is greater than 95 for 5 minutes, put the component in the down state.