IdleTrigger (triggerGroup) Element

Specifies a trigger that starts a task when the computer goes into an idle state. For information about idle conditions, see Task Idle Conditions.

<xs:element name="IdleTrigger"
    type="idleTriggerType"
 />

The IdleTrigger element is defined by the triggerGroup .

Parent element

ElementDerived fromDescription
Triggers triggersType

Specifies the triggers that start the task.

Child elements

ElementTypeDescription
Enabled (triggerBaseType) boolean

Specifies that the trigger is enabled.

EndBoundary (triggerBaseType) dateTime

Specifies the date and time when the trigger is deactivated. The trigger cannot start the task after it is deactivated.

ExecutionTimeLimit (triggerBaseType) duration

Specifies the maximum amount of time in which the task can be started by the trigger.

Repetition (triggerBaseType) repetitionType

Specifies how often the task is run and how long the repetition pattern is repeated after the task is started.

StartBoundary (triggerBaseType) dateTime

Specifies the date and time when the trigger is activated.

Attributes

NameTypeDescription
Idstring

The identifier of the trigger.

Remarks

For scripting development, an idle trigger is specified using the IdleTrigger object.

For C++ development, an idle trigger is specified using the IIdleTrigger interface.

The child elements listed above are defined by the triggerBaseType complex element types. These elements must be added in the sequence shown below.

Examples

The following XML defines an idle trigger.


<IdleTrigger>
    <StartBoundary>2005-01-01T00:08:00</StartBoundary>
    <EndBounadry>2007-01-01T00:08:00</EndBoundary>
    <Enabled></Enabled>
    <Repetition></Repetition>
    <ExecutionTimeLimit></ExecutionTimeLimit>
</IdleTrigger>

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

See also

Task Scheduler Schema Elements
Task Scheduler

 

 

Show: