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
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 |
|
| DLL |
|