Principals (taskType) Element
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] |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for