Evaluators

For a number of Tasks that query objects, it is possible to configure evaluators. Evaluators are very similar to conditions, but where a condition determines what actions should be taken before a Task is executed, an evaluator does this afterwards: An evaluator contains one or more expressions that determine whether the evaluator can be satisfied based on the query results. Upon this, the evaluator takes a certain action, either continue or fail the query. This makes it possible to let the execution of succeeding Tasks depend on the results of a query. You can also use evaluators, for example, to check whether a server meets the compliancy rules of your organization.

Different from conditions, evaluators do not contain a fixed set of available criteria on which you can base expressions. The list of available criteria depends on the nature of the Task in which the evaluator is used.

Overview of Tasks in which evaluators can be used:

Query Active Directory Computer
Query Active Directory Group
Query Active Directory Object
Query Active Directory Organizational Unit (OU)
Query Active Directory User
Query Certificate
Query Computer Inventory
Query Computer Properties
Query Disk Space
Query Environment Variables
Query Event Logs
Query Files
Query Installed Programs
Query Local Group
Query Parameters
Query Printer
Query Printer Driver
Query Service Properties
Query TCP/IP Properties

Examples

Scenario: Install applications only on Agents with sufficient disk space

Scenario: Add Active Directory users to Distribution Lists

You can also use evaluators to check Agent on compliancy. For example, you can configure an evaluator

for a Task Query Service Properties to check whether a certain service is running on an Agent.
for a Task Query Disk Space to check the minimum disk space on an Agent.
for a Task Query Installed programs to check whether a certain application version has been installed.

Configuration

You can use several operators when configuring an evaluator. See Pattern Matching: wildcards and operators for an overview.
Optionally, you can set a parameter as part of the action of an evaluator. This allows you to use a value that is returned by an evaluator in a succeeding Task, for example as part of a condition on this Task.

When viewing the detailed Job history of these Tasks, you can use the option Only show data returned by evaluator to filter the results of the query.
Because an evaluator can specify that a query should fail, the Tasks that can be configured with an evaluator also contain error control settings. The default value of error control for these Tasks is Continue Job on error, whereas the default value of other Tasks is Stop Job on error.
The use of Global Variables in Run Book parameters, conditions and evaluators is not supported.