Méthode TaskFolder.RegisterTaskDefinition

Pour le script, inscrit (crée) une tâche à un emplacement spécifié à l’aide de l’objet TaskDefinition pour définir une tâche.

Syntaxe

TaskFolder.RegisterTaskDefinition( _
  ByVal path, _
  ByVal definition, _
  ByVal flags, _
  ByVal userId, _
  ByVal password, _
  ByVal logonType, _
  [ ByVal sddl ], _
  ByRef task _
)

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.

definition [in]

Définition de la tâche inscrite.

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.RegisterTaskDefinition 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. Le cas échéant, ces informations d’identification sont prioritaires sur les informations d’identification spécifiées dans l’objet de définition de tâche pointé par le paramètre de définition .

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 la propriété Compatibility est définie sur 1 dans les paramètres de la tâche.

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.

tâche [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 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.

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

Vous pouvez inscrire une tâche avec succès 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écutera 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