Execute External Process

Overview

This filter enables you to execute an external process from a policy. You can use this filter to execute any external process (for example, start an SSH session to connect to another machine, run a script, or send an SMS message).

Configuration

To configure the Execute Process filter, specify the following fields:

Name:

Name of the filter to be displayed in a policy. Defaults to Execute process.

Command tab

This tab includes the following fields:

Command to execute Specify the full path to the command that you wish to execute (for example, c:\cygwin\bin\mkdir.exe).
Arguments Click the Add button to add arguments to your command. Specify an argument in the Value field (for example, dir1), and click OK. Repeat these steps to add multiple arguments (for example, dir2 and dir3).
Working directory Specify the directory to run the command from. You can specify this using a selector that is expanded to the specified value at runtime. Defaults to ${environment.VINSTDIR}, where VINSTDIR is the root of your installation. For more details on selectors, see Selecting Configuration Values at Runtime.
Expected exit code Specify the expected exit code for the process when it has finished. Defaults to 0.
Kill if running longer than (ms) Specify the number of milliseconds after which the running process is killed. Defaults to 60000.


Advanced tab

This tab includes the following fields:

Environment variables to set Click Add to add environment variables. In the dialog, specify an Environment variable name (for example, JAVA_HOME) and a Value (for example, c:\jdk1.6.0_18), and click OK. Repeat to add multiple variables.
Block till process finished Select whether to block until the process is finished in the checkbox. This is enabled by default.