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

Element Derived from Description
Settings settingsType Contains the settings that the Task Scheduler uses to perform the task.

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

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]

See also

Task Scheduler Schema Elements