Windows Dev Center

Expand Minimize

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

ElementDerived fromDescription
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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

See also

Task Scheduler Schema Elements

 

 

Community Additions

ADD
Show:
© 2015 Microsoft