Partager via


Objet RegisteredTask

Objet de script qui fournit les méthodes utilisées pour exécuter la tâche immédiatement, obtenir toutes les instances en cours d’exécution de la tâche, obtenir ou définir les informations d’identification utilisées pour inscrire la tâche et les propriétés qui décrivent la tâche.

Membres

L’objet RegisteredTask a les types de membres suivants :

Méthodes

L’objet RegisteredTask a ces méthodes.

Méthode Description
GetInstances Retourne toutes les instances de la tâche inscrite qui sont en cours d’exécution.
GetRunTimes Obtient les heures auxquelles la tâche inscrite est planifiée pour s’exécuter pendant une heure spécifiée.
GetSecurityDescriptor Obtient le descripteur de sécurité utilisé comme informations d’identification pour la tâche inscrite.
Exécuter Exécute immédiatement la tâche inscrite.
RunEx Exécute immédiatement la tâche inscrite à l’aide d’indicateurs spécifiés et d’un identificateur de session.
SetSecurityDescriptor Définit le descripteur de sécurité utilisé comme informations d’identification pour la tâche inscrite.
Arrêter Arrête immédiatement la tâche inscrite.

Propriétés

L’objet RegisteredTask a ces propriétés.

Propriété Type d’accès Description
Définition
Lecture seule
Obtient la définition de la tâche.
activé
Lecture/écriture
Obtient ou définit une valeur booléenne qui indique si la tâche inscrite est activée.
LastRunTime
Lecture seule
Obtient l’heure de la dernière exécution de la tâche inscrite.
LastTaskResult
Lecture seule
Obtient les résultats retournés lors de la dernière exécution de la tâche inscrite.
Nom
Lecture seule
Obtient le nom de la tâche inscrite.
NextRunTime
Lecture seule
Obtient l’heure à laquelle l’exécution prochaine de la tâche inscrite est planifiée.
NumberOfMissedRuns
Lecture seule
Obtient le nombre de fois où la tâche inscrite a manqué une exécution planifiée.
Path
Lecture seule
Obtient le chemin d’accès à l’emplacement de stockage de la tâche inscrite.
State
Lecture seule
Obtient l’état opérationnel de la tâche inscrite.
XML
Lecture seule
Obtient les informations d’inscription au format XML pour la tâche inscrite.

Exemples

Pour plus d’informations et un exemple de code pour cet objet de script, consultez Time Trigger Example (Scripting) et Displaying Task Names and States (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
Taskschd.tlb
DLL
Taskschd.dll