MultipleInstancesPolicy (settingsType) Element

Specifies the policy that defines how the Task Scheduler deals with multiple instances of the task.

<xs:element name="MultipleInstancesPolicy"
    type="multipleInstancesPolicyType"
 />

The MultipleInstancesPolicy element is defined by the multipleInstancesPolicyType simple type.

Parent element

Remarks

For C++ development, see MultipleInstances Property of ITaskSettings.

For script development, see TaskSettings.MultipleInstances.

Restricted Values

This element is restricted to the following values.

• Parallel: Starts a new instance while an existing instance is running.
• Queue: Starts a new instance of task after all other instances of the task are complete.
• IgnoreNew: Default. Does not start a new instance if an existing instance of the task is running.
• StopExisting: Stops an existing instance of the task before it starts a new instance.

Examples

The following XML defines a settings element that allows multiple instances of the task to run in parallel.

<Settings>
    <MultipleInstancesPolicy>Parallel</MultipleInstancesPolicy>
</Settings>

Requirements

See also

Task Scheduler Schema Elements