Propriété Principal.LogonType

Article
06/12/2023

Pour les scripts, 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.

Syntaxe

Principal.LogonType As Integer

Valeur de la propriété

Définissez l’une des constantes d’énumération TYPE TASK_LOGON suivantes.

Valeur	Signification
TASK_LOGON_NONE 0	La méthode d’ouverture de session n’est pas spécifiée. Utilisé pour les informations d’identification non NT.
TASK_LOGON_PASSWORD 1	Utilisez un mot de passe pour la journalisation sur l’utilisateur. Le mot de passe doit être fourni au moment de l’inscription.
TASK_LOGON_S4U 2	Utilisez un jeton interactif existant pour exécuter une tâche. L’utilisateur doit se connecter à l’aide d’un service pour l’ouverture de session utilisateur (S4U). Lorsqu’une ouverture de session S4U est utilisée, aucun mot de passe n’est stocké par le système et il n’y a aucun accès au réseau ou aux fichiers chiffrés.
TASK_LOGON_INTERACTIVE_TOKEN 3	L’utilisateur doit déjà être connecté. La tâche sera exécutée uniquement dans une session interactive existante.
TASK_LOGON_GROUP 4	Activation de groupe. Le champ userId spécifie le groupe.
TASK_LOGON_SERVICE_ACCOUNT 5	Indique qu’un compte système local, service local ou service réseau est utilisé comme contexte de sécurité pour exécuter la tâche.
TASK_LOGON_INTERACTIVE_TOKEN_OR_PASSWORD 6	Commencez par utiliser le jeton interactif. Si l’utilisateur n’est pas connecté (aucun jeton interactif n’est disponible), le mot de passe est utilisé. Le mot de passe doit être spécifié lorsqu’une tâche est inscrite. Cet indicateur n’est pas recommandé pour les nouvelles tâches, car il est moins fiable que TASK_LOGON_PASSWORD.

Notes

Cette propriété est valide uniquement lorsqu’un identificateur d’utilisateur est spécifié par la propriété UserId .

Lors de la lecture ou de l’écriture de CODE XML pour une tâche, le type d’ouverture de session est spécifié dans l’élément <LogonType> du schéma Task Scheduler.

Pour une tâche, qui contient une action de boîte de message, la zone de message s’affiche si la tâche est activée et si la tâche a un type d’ouverture de session interactif. Pour définir le type d’ouverture de session de tâche sur interactif, spécifiez 3 (TASK_LOGON_INTERACTIVE_TOKEN) ou 4 (TASK_LOGON_GROUP) dans la propriété LogonType du principal de la tâche, ou dans le paramètre logonType de TaskFolder.RegisterTask ou TaskFolder.RegisterTaskDefinition.

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

Voir aussi

Planificateur de tâches
Principal