PowerShell Guidelines for ActiveXperts Network Monitor

Introduction

PowerShell is a command-line shell with associated scripting language from Microsoft. It was released in 2006, and is currently available for all major Windows Operating Systems,

ActiveXperts Network Monitor requires PowerShell v.1 or higher.

Installing and enabling PowerShell

If PowerShell is not enabled on your computer, you need to install it first. If PowerShell is not installed it can be downloaded from the Microsoft Download Center. ActiveXperts Network Monitor requires Windows PowerShell 1.0 or higher.


Enabling PowerShell scripts

Out of the box, the Operating System does not allow you (or ActiveXperts Network Monitor) to run PowerShell scripts. You must enable PowerShell scripting first from the command line.

Please note that allowing Powershell scripts for Network Monitor in 64-bits operating systems is different from 32-bits operating systems.

Enabling PowerShell scripts on 32-bits Operating Systems

To allow execution of Powershell scripts on 32-bits operating sytems, please do the following:

Enabling PowerShell scripts on 64-bits Operating Systems

ActiveXperts Network Monitor runs as a 32-bit service. Therefore, it runs Powershell scripts in a 32-bit context. To allow execution of Powershell scripts on 64-bits operating sytems, please do the following:


Using PowerShell scripts for ActiveXperts Network Monitor

In order to use PowerShell with Network Monitor, PowerShell needs to be installated on the monitoring server. It is not required to have PowerShell installed on the monitored server!

ActiveXperts Network Monitor ships with a set of PowerShell that run out of the box. These can be used to check servers and can be modified in order to meet your requirements. ActiveXperts Network Monitor requires the output (i.e. StdOut) of the PowerShell script to be formatted according to the following syntax:

[ SUCCESS | ERROR | UNCERTAIN]: { <explanation> } { DATA:<value>}

The <explanation> will be shown in the 'Last Response' column in the Manager application. The <value> field will be shown in the 'Data' column in the Manager application. For example:

ERROR: Free disk space is less than 40 GB DATA:34

SUCCESS: Free disk space is more than 40 GB DATA:102