Partager via


Méthode RegisteredTask.Run

Pour les scripts, exécute la tâche inscrite immédiatement.

Syntaxe

RegisteredTask.Run( _
  ByVal params, _
  ByRef ppRunningTask _
)

Paramètres

params [in]

Paramètres utilisés comme valeurs dans les actions de tâche. Pour ne spécifier aucune valeur de paramètre pour les actions de tâche, définissez ce paramètre sur Nothing. Sinon, une valeur de chaîne unique ou un tableau de valeurs de chaîne peut être spécifié.

Les valeurs de chaîne que vous spécifiez sont associées à des noms et stockées sous forme de paires nom-valeur. Si vous spécifiez une valeur de chaîne unique, Arg0 sera le nom attribué à la valeur. La valeur peut être utilisée dans l’action de tâche où la variable $(Arg0) est utilisée dans les propriétés de l’action.

Si vous transmettez des valeurs telles que « 0 », « 100 » et « 250 » en tant que tableau de valeurs de chaîne, « 0 » remplace les variables $(Arg0), « 100 » remplace les variables $(Arg1) et « 250 » remplace les variables $(Arg2) utilisées dans les propriétés d’action.

Un maximum de 32 valeurs de chaîne peut être spécifié.

Pour plus d’informations et pour obtenir la liste des propriétés d’action qui peuvent utiliser les variables $(Arg0), $(Arg1), ..., $(Arg32) dans leurs valeurs, consultez Actions de tâche.

ppRunningTask [out]

Objet RunningTask qui définit la nouvelle instance de la tâche.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

La fonction RegisteredTask.Run est équivalente à la fonction RegisteredTask.RunEx avec le paramètre flags égal à 0 et rien spécifié pour le paramètre utilisateur.

Cette méthode retourne sans erreur, mais la tâche ne s’exécute pas si la propriété TaskSettings.AllowDemandStart a la valeur false pour la tâche inscrite.

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