Élément Principal (principalType)

Article
06/12/2023

Spécifie les informations d’identification de sécurité d’un principal. Ces informations d’identification définissent le contexte de sécurité sous lequel une tâche s’exécute.

<xs:element name="Principal"
    type="principalType"
 />

L’élément Principal est défini par le type complexe principalType .

Élément parent

Élément	Dérivé de	Description
Principaux	principalsType	Spécifie les principaux de sécurité associés à la tâche.

Éléments enfants

Élément	Type	Description
DisplayName	string	Spécifie le nom du principal affiché dans l’interface utilisateur du planificateur de tâches.
Groupid	string	Spécifie l’identificateur du groupe d’utilisateurs requis pour exécuter les tâches associées au principal.
LogonType	logonType	Spécifie la méthode d’ouverture de session de sécurité requise pour exécuter les tâches associées au principal.
Userid	string	Spécifie l’identificateur d’utilisateur requis pour exécuter les tâches associées au principal.

Attributs

Nom	Type	Description
Id	id	Identificateur de la définition du principal.

Notes

Pour le développement de scripts, les informations d’identification de sécurité d’un principal sont spécifiées à l’aide de l’objet Principal .

Pour le développement C++, les informations d’identification de sécurité d’un principal sont spécifiées à l’aide de l’interface IPrincipal .

Les éléments enfants répertoriés ci-dessus sont définis par le type complexe principalType . Pour plus d’informations sur le séquencement de ces éléments enfants, consultez principalType.

Exemples

Le code XML suivant définit un principal avec un identificateur d’utilisateur.

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

Le code XML suivant définit un principal avec un identificateur de groupe.

<Principals>
    <Principal>
        <GroupId></GroupId>
        <DisplayName></DisplayName>
    </Principal>
</Principals>

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]

Voir aussi

Planificateur de tâches