Objet Principal

Objet de script qui fournit les informations d’identification de sécurité d’un principal. Ces informations d’identification de sécurité définissent le contexte de sécurité pour les tâches associées au principal.

Membres

L’objet Principal a les types de membres suivants :

• Propriétés

Propriétés

L’objet Principal a ces propriétés.

Propriété	Type d’accès	Description
DisplayName	Lecture/écriture	Obtient ou définit le nom du principal affiché dans l’interface utilisateur du planificateur de tâches.
Groupid	Lecture/écriture	Obtient ou définit l’identificateur du groupe d’utilisateurs requis pour exécuter les tâches associées au principal.
Id	Lecture/écriture	Obtient ou définit l'identificateur unique du principal.
LogonType	Lecture/écriture	Obtient ou définit la méthode d’ouverture de session de sécurité requise pour exécuter les tâches associées au principal.
Runlevel	Lecture/écriture	Obtient ou définit l’identificateur utilisé pour spécifier le niveau de privilège requis pour exécuter les tâches associées au principal.
Userid	Lecture/écriture	Obtient ou définit l’identificateur d’utilisateur requis pour exécuter les tâches associées au principal.

Notes

Lorsque vous spécifiez un compte, n’oubliez pas d’utiliser correctement la double barre oblique inverse dans le code pour spécifier le domaine et le nom d’utilisateur. Par exemple, utilisez DOMAIN\\UserName pour spécifier une valeur pour la propriété UserId .

Lors de la lecture ou de l’écriture de code XML pour une tâche, les informations d’identification de sécurité d’un principal sont spécifiées dans l’élément Principal du schéma du planificateur de tâches.

Si une tâche est inscrite à l’aide de l’outil en ligne de commande at.exe et que cet objet est utilisé pour récupérer des informations sur la tâche, la propriété LogonType renvoie 0, la propriété RunLevel renvoie 0 et la propriété UserId renvoie Nothing.

Exemples

Pour plus d’informations et un exemple de code pour cet objet de script, consultez Time Trigger Example (Scripting) .

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]
Bibliothèque de types	Taskschd.tlb
DLL	Taskschd.dll