PowerShell Sensor (Enterprise Edition only)

<< Click to Display Table of Contents >>

Navigation:  Sensors > Misc Sensors >

PowerShell Sensor (Enterprise Edition only)

The PowerShell Sensor allows you to execute a PowerShell script on a target host. The values from variables defined in the script can be extracted to be used in conditions.

Requirements:

To execute the sensor on a remote host PowerShell remoting must be enabled on this host. Please refer to the Microsoft article for further details.

Sensor Tasks

Test Sensor

Tests the current sensor settings.

Get Help

Opens the ServerSentinel online help for the current sensor.

Basic Settings

Name

The name of the sensor (max. 100 characters). Choose a meaningful name to clearly identify the sensor.

Sensor is Active

Toggles the sensor ON/OFF.

Check Interval

The interval or times at which which the sensor should perform its checks.

Simple

The sensor performs its checks every x time units, e.g. every 10 minutes.

Daily

The sensor performs its checks daily at one or more (max. 4) fixed times, e.g. daily at 0 and 12 o'clock.

Weekly

The sensor performs its checks at certain days of the weeks at one or more (max. 4) fixed times, e.g. monday to friday at 12 o'clock.

Monthly

The sensor performs its checks at certain days of the month at one or more (max. 4) fixed times, e.g. every 1st of the month at 12 o'clock.

Only check if this Sensor didn't fail

This sensor will only be checked, if the sensor in the drop down list didn't fail.

Further Information

Comment

Short additional information to the sensor (max. 255 characters).

Connection Settings

Host

The DNS name of the host on which the script should be executed (max. 255 characters).

Port

The port which is used to connect to the target host.

Credential

Here you can either select an existing credential set or create a new one by inserting a display name, an username and a password.

Script Settings

Script

The PowerShell script which should be executed on the target host.

Parameters

The values for the parameters expected by the script that will be passed to it during execution.

Timeout

The maximum duration the script should be executed in seconds. If the script is still running when the timeout is reached, it will be terminated.

Meta Data Values

Data Value

Data Type

Description

Checktime

Date

The time the dataset has been created.

Exception Message

String

The message of the error if any occurred.

Response Time

Integer

The response time needed to perform the check.

Status

String

A status string that may contain arbitrary information that was collected by the sensor (max. 255 characters). Per default this value is empty.

Status Flag

Enum

The status of the sensor after the check has been performed.

Besides the values above also any defined variable will be listed.