Edit

Share via

principalType Complex Type

  • Article

Defines the attribute, child elements, and sequencing information for the Principal element.

<xs:complexType name="principalType">
    <xs:all>
        <xs:element name="UserId"
            type="nonEmptyString"
            minOccurs="0"
         />
        <xs:element name="LogonType"
            type="logonType"
            minOccurs="0"
            maxOccurs="1"
         />
        <xs:element name="GroupId"
            type="nonEmptyString"
            minOccurs="0"
         />
        <xs:element name="DisplayName"
            type="string"
            minOccurs="0"
         />
        <xs:element name="RunLevel"
            type="runLevelType"
            minOccurs="0"
         />
        <xs:element name="ProcessTokenSidType"
            type="processTokenSidType"
            minOccurs="0"
            maxOccurs="1"
         />
        <xs:element name="RequiredPrivileges"
            type="requiredPrivilegesType"
            minOccurs="0"
         />
    </xs:all>
    <xs:attribute name="id"
        type="ID"
        use="optional"
     />
</xs:complexType>

Child elements

Element Type Description
DisplayName string Specifies the name of the principal that is displayed in the Task Scheduler user interface (UI).
GroupId nonEmptyString Specifies the identifier of the user group that is required to run tasks that are associated with the principal.
LogonType logonType Specifies the security logon method that is required to run tasks that are associated with the principal.
ProcessTokenSidType processTokenSidType Specifies the types of process security identifier (SID) that can be used by tasks.
RequiredPrivileges requiredPrivilegesType Specifies the required privileges to run the task.
RunLevel runLevelType Specifies the permission level that the task will be run at.
UserId nonEmptyString Specifies the user identifier that is required to run tasks that are associated with the principal.

Attributes

Name Type Description
id ID Specifies the identifier of the principal.

Requirements

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

See also

Task Scheduler Schema Complex Types

Task Scheduler