Task Properties: Windows Task
Property |
UI Field Name |
Description |
Specifications |
Required |
---|---|---|---|---|
|
Command |
If |
Variables supported. |
N |
|
Command or Script |
Specification for whether a single command or a script is being executed. |
Valid values: Default is Command (1). |
N |
|
Create Console |
If |
Boolean; Valid values: true/false. Default is false. |
N |
|
Interact with Desktop |
Specification for whether or not a task that runs an application with a GUI requires some manual actions from a user (for example, clicking buttons or entering values). |
Boolean; Valid values: true/false. Default is false. |
N |
|
Run with Highest Privileges |
Specification for whether or not to execute the task using an elevated privileges token, rather than one subject to User Account Control (UAC) restrictions. An elevated token allows a process to execute with all the privileges available to its specified credentials. For example, a task executed with an administrative account will behave as though it received permission via a UAC dialog to perform a privileged operation. |
Boolean; Valid values: true/false. Default is false. |
N |
|
Environment Variables |
Environment variables needed by the program to run. |
List of environment variables: |
N |
|
Output File |
If |
|
N |
|
Exit Code Processing |
Specification for how the Controller should determine whether the executed command failed or completed successfully. |
Valid values: Default is Success Exitcode Range (1). |
N |
|
Exit Codes |
If |
Format: Numeric. Use commas to list a series of exit codes; use hyphens to specify a range. Example: 1,5, 22-30. |
Y |
|
Scan Output For |
If |
The Controller will process this field as a regular expression. |
Y |
|
Failure Only |
If |
Boolean; Valid values: true/false. Default is false. |
N |
|
Output File |
If |
|
Y |
|
Number of Lines |
If |
Integer; Default is the value of the Retrieve Output Default Maximum Lines Universal Controller system property. |
N |
|
Starting Line |
If |
Integer; Default is 1. |
N |
|
Scan Text |
If |
The Controller will process this field as a regular expression. |
N |
|
Automatic Output Retrieval |
Specification for whether you want the Controller to automatically retrieve any output from the job and attach it to the task instance record. |
Valid values: Default is NONE (1). Note If |
N |
|
Output Type |
If |
Valid values: Default is STDOUT (1). |
Y |
|
Parameters |
Any arguments needed by the program to execute properly. |
Variables are supported. |
N |
|
Retry Exit Codes |
Exit code range for which an auto-retry of the task in FAILED status will occur. Exit code ranges must be in the same format as ranges specified in |
Format = 1,5,22-30 |
N |
|
Retry Indefinitely |
Specification for whether or not the Controller should continue trying indefinitely to run this task. If |
Boolean; Valid values: true/false. Default is false. |
N |
|
Retry Interval |
Number of seconds between each retry. |
Integer; Default is 60. |
N |
|
Maximum Retries |
Maximum number of times that the Controller should retry this task after it has started and gone to a failed state. |
Integer; Default is 0. |
N |
|
Suppress Intermediate Failures |
Specification for whether or not the following will be suppressed until all scheduled retry attempts have been made:
|
Boolean; Valid values: true/false. Default is false. |
N |
|
Runtime Directory |
Directory from which the application should be executed. Variables are supported. |
|
N |
|
Script |
If |
|
Y |
|
Wait For Output |
If |
Boolean; Valid values: true/false. Default is false. |
N |