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] |