MultipleInstancesEnum not described

[colinangusmackay]

There is a parameter called -MultipleInstances the type of which is MultipleInstancesEnum, however this type is not described, nor it is linked to. The upshot of this is that I don't know what are the valid values for the MultipleInstances parameter and what each value means.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 01873db6-65ca-a11d-442d-0836caca5d8e
• Version Independent ID: a1c11fee-27d9-0267-5a7a-6e0acca5d306
• Content: New-ScheduledTaskSettingsSet (scheduledtasks)
• Content Source: docset/windows/scheduledtasks/new-scheduledtasksettingsset.md
• Service: w10
• GitHub Login: @brianlic-msft
• Microsoft Alias: brianlic

[bladeoflight16]

The fully qualified name of the enum is Microsoft.PowerShell.Cmdletization.GeneratedTypes.ScheduledTask.MultipleInstancesEnum. With this name in hand, you can list the values:

PS> [System.Enum]::GetNames([Microsoft.PowerShell.Cmdletization.GeneratedTypes.ScheduledTask.MultipleInstancesEnum])
Parallel
Queue
IgnoreNew

These values are also found in the "Accepted values" row of the table below the parameter.

I believe the meanings are as follows:

Value	Meaning	Corresponding Value in Task Scheduler Interface
Parallel	Run a new instance in parallel	Run a new instance in parallel
Queue	Wait until the current instance finishes and then execute this one.	Queue a new instance
IgnoreNew	Do not start a new instance	Do not start a new instance
???	Kill the process for the currently running instance	Stop the existing instance

"Stop the existing instance" from the Task Scheduler UI conspicuously has no enum value.

This does still need to be documented in the page better. If it's not going to be linked to an actual documentation page, the meanings at least need to be specified.

[o0nj]

@officedocsbot assign @yogkumgit

[get-itips]

Hi @colinangusmackay thanks for your feedback.
A PR has been created to improve the article based on your suggestion.
Thank you!

[yogkumgit]

@kenwith please merge this PR, if you find it suitable

[yogkumgit]

@get-itips Thank you very much for the contribution and updating the documentation with PR. @colinangusmackay Hope this update is helpful for you. Thanks for taking out some time to open the issue. Appreciate and encourage you to do the same in future also.

[yogkumgit]

@officedocsbot close

[colinangusmackay]

Thank you. It is much appreciated.

[Rob-S]

It was noted above that:

"Stop the existing instance" from the Task Scheduler UI conspicuously has no enum value.

Value in Task Scheduler Interface: Stop the existing instance
Value in Task XML file: StopExisting
Meaning: Kill the process for the currently running instance

That value is missing from the Microsoft.PowerShell.Cmdletization.GeneratedTypes.ScheduledTask.MultipleInstancesEnum but is needed for ComputerManagementDsc Issue#333 ScheduledTask: MultipleInstances Parameter Should Allow For 'StopExisting'

Question: Where do we file the bug issue for that?