Partager via

Méthode TaskFolder.RegisterTask

  • Article

Pour le script, inscrit (crée) une tâche dans le dossier à l’aide de XML pour définir la tâche.

Syntaxe

TaskFolder.RegisterTask( _
  ByVal path, _
  ByVal xmlText, _
  ByVal flags, _
  ByVal userId, _
  ByVal password, _
  ByVal logonType, _
  [ ByVal sddl ], _
  ByRef pTask _
)

Paramètres

path [in]

Nom de la tâche. Si cette valeur est Nothing, la tâche est inscrite dans le dossier de tâches racine et le nom de la tâche est une valeur GUID créée par le service Planificateur de tâches.

Un nom de tâche ne peut pas commencer ou se terminer par un espace. Le caractère '.' ne peut pas être utilisé pour spécifier le dossier de tâches actuel et le '..' les caractères ne peuvent pas être utilisés pour spécifier le dossier de tâches parent dans le chemin d’accès.

xmlText [in]

Description au format XML de la tâche.

Les rubriques suivantes contiennent des tâches définies à l’aide de XML.

indicateurs [in]

Constante TASK_CREATION .

Valeur Signification
TASK_VALIDATE_ONLY
0x1
 Le planificateur de tâches vérifie la syntaxe du code XML qui décrit la tâche, mais n’inscrit pas la tâche. Cette constante ne peut pas être combinée avec les valeurs TASK_CREATE, TASK_UPDATE ou TASK_CREATE_OR_UPDATE .
TASK_CREATE
0x2
 Le planificateur de tâches inscrit la tâche en tant que nouvelle tâche.
TASK_UPDATE
0x4
 Le planificateur de tâches inscrit la tâche en tant que version mise à jour d’une tâche existante. Lorsqu’une tâche avec un déclencheur d’inscription est mise à jour, la tâche s’exécute une fois la mise à jour effectuée.
TASK_CREATE_OR_UPDATE
0x6
 Le planificateur de tâches inscrit la tâche en tant que nouvelle tâche ou en tant que version mise à jour si la tâche existe déjà. Équivalent à TASK_CREATE | TASK_UPDATE.
TASK_DISABLE
0x8
 Le planificateur de tâches désactive la tâche existante.
TASK_DONT_ADD_PRINCIPAL_ACE
0x10
 Le planificateur de tâches ne peut pas ajouter l’entrée d’autorisation de contrôle d’accès (ACE) pour le principal de contexte. Lorsque la fonction TaskFolder.RegisterTask est appelée avec cet indicateur pour mettre à jour une tâche, le service Planificateur de tâches n’ajoute pas l’ACE pour le nouveau principal de contexte et ne supprime pas l’ace de l’ancien principal de contexte.
TASK_IGNORE_REGISTRATION_TRIGGERS
0x20
 Le planificateur de tâches crée la tâche, mais ignore les déclencheurs d’inscription dans la tâche. En ignorant les déclencheurs d’inscription, la tâche ne s’exécute pas lorsqu’elle est inscrite, sauf si un déclencheur basé sur le temps l’oblige à s’exécuter lors de l’inscription.

userId [in]

Informations d’identification de l’utilisateur utilisées pour inscrire la tâche.

Notes

Si la tâche est définie en tant que tâche Planificateur de tâches 1.0, n’utilisez pas de nom de groupe (plutôt qu’un nom d’utilisateur spécifique) dans ce paramètre userId. Une tâche est définie en tant que tâche Planificateur de tâches 1.0 lorsque l’attribut de version de l’élément Task dans le xml de la tâche est défini sur 1.1.

password [in]

Mot de passe de l’id utilisateur utilisé pour inscrire la tâche. Lorsque le type d’ouverture de session TASK_LOGON_SERVICE_ACCOUNT est utilisé, le mot de passe doit être une valeur VARIANT vide telle que VT_NULL ou VT_EMPTY.

logonType [in]

Définit la technique d’ouverture de session utilisée pour exécuter la tâche inscrite.

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 vous connecter à 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 groupId 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
 Utilisez d’abord 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é lors de l’inscription d’une tâche. Cet indicateur n’est pas recommandé pour les nouvelles tâches, car il est moins fiable que TASK_LOGON_PASSWORD.

sddl [in, facultatif]

Descripteur de sécurité associé à la tâche inscrite. Vous pouvez spécifier la liste de contrôle d’accès (ACL) dans le descripteur de sécurité d’une tâche afin d’autoriser ou de refuser l’accès à une tâche à certains utilisateurs et groupes.

Notes

Si le compte Système local se voit refuser l’accès à une tâche, le service Planificateur de tâches peut produire des résultats inattendus.

pTask [out]

Objet RegisteredTask qui représente la nouvelle tâche.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

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 interactive. 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.

Seul un membre du groupe Administrateurs peut créer une tâche avec un déclencheur de démarrage.

Vous pouvez inscrire correctement une tâche avec un groupe spécifié dans le paramètre userId et 3 (TASK_LOGON_INTERACTIVE_TOKEN) spécifié dans le paramètre logonType de TaskFolder.RegisterTask ou TaskFolder.RegisterTaskDefinition, mais la tâche ne s’exécute pas.

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

RegisteredTask

TaskFolder