TaskCreation Enumeration

Defines how the Task Scheduler service creates, updates, or disables the task.

Definition

Namespace: Microsoft.Win32.TaskScheduler
Assembly: Microsoft.Win32.TaskScheduler (in Microsoft.Win32.TaskScheduler.dll) Version: 2.11.1
C#Request Example
[DefaultValueAttribute(TaskCreation.CreateOrUpdate)]
public enum TaskCreation

Members

ValidateOnly1 The Task Scheduler service checks the syntax of the XML that describes the task but does not register the task. This constant cannot be combined with the Create, Update, or CreateOrUpdate values.
Create2The Task Scheduler service registers the task as a new task.
Update4 The Task Scheduler service registers the task as an updated version of an existing task. When a task with a registration trigger is updated, the task will execute after the update occurs.
CreateOrUpdate6 The Task Scheduler service either registers the task as a new task or as an updated version if the task already exists. Equivalent to Create | Update.
Disable8 The Task Scheduler service registers the disabled task. A disabled task cannot run until it is enabled. For more information, see Enabled Property of TaskSettings and Enabled Property of RegisteredTask.
DontAddPrincipalAce16 The Task Scheduler service is prevented from adding the allow access-control entry (ACE) for the context principal. When the TaskFolder.RegisterTaskDefinition or TaskFolder.RegisterTask functions are called with this flag to update a task, the Task Scheduler service does not add the ACE for the new context principal and does not remove the ACE from the old context principal.
IgnoreRegistrationTriggers32 The Task Scheduler service creates the task, but ignores the registration triggers in the task. By ignoring the registration triggers, the task will not execute when it is registered unless a time-based trigger causes it to execute on registration.

See Also