Principals (taskType) Element

Article
12/11/2020

Specifies the security contexts that can be used to run the task.

<xs:element name="Principals"
    type="principalsType"
 />

The Principals element is defined by the taskType complex type.

Parent element

Element	Derived from	Description
Task	taskType	Defines the task that is performed by the Task Scheduler service.

Child elements

Element	Type	Description
Principal	principalType	Specifies the security credentials for a principal.

Remarks

You can specify up to 32 principals for a task.

For scripting development, the principals of a task are specified using the TaskDefinition.Principal property.

For C++ development, the principals of a task are specified using the Principal property of ITaskDefinition.

Examples

The following XML defines two principals: a user identifier and group identifier principal for the task.

<Principals>
    <Principal>
        <UserId></UserId>
        <LogonType><LogonType>
        <DisplayName></DisplayName>
    </Principal>
    <Principal>
        <GroupId></GroupId>
        <DisplayName></DisplayName>
    </Principal>
</Principals>

Requirements

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