Objet TaskSettings
Objet de script qui fournit les paramètres que le service Planificateur de tâches utilise pour effectuer la tâche.
Membres
L’objet TaskSettings a les types de membres suivants :
Propriétés
L’objet TaskSettings possède ces propriétés.
| Propriété | Type d’accès | Description |
|---|---|---|
|
AllowDemandStart |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que la tâche peut être démarrée à l’aide de la commande Exécuter ou du menu contextuel. |
|
AllowHardTerminate |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que la tâche peut être terminée à l’aide de TerminateProcess. |
|
Compatibilité |
Lecture/écriture |
Obtient ou définit une valeur entière qui indique la version du planificateur de tâches avec laquelle une tâche est compatible. |
|
DeleteExpiredTaskAfter |
Lecture/écriture |
Obtient ou définit la durée pendant laquelle le planificateur de tâches attend avant de supprimer la tâche après son expiration. |
|
InterdireStartIfOnBatteries |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que la tâche ne sera pas démarrée si l’ordinateur fonctionne sur batterie. |
|
activé |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que la tâche est activée. La tâche ne peut être effectuée que lorsque ce paramètre a la valeur True. |
|
ExecutionTimeLimit |
Lecture/écriture |
Obtient ou définit la durée autorisée pour effectuer la tâche. |
|
Hidden |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que la tâche ne sera pas visible dans l’interface utilisateur. Toutefois, les administrateurs peuvent remplacer ce paramètre en utilisant un « commutateur master » qui rend toutes les tâches visibles dans l’interface utilisateur. |
|
IdleSettings |
Lecture/écriture |
Obtient ou définit les informations qui spécifient la façon dont le Planificateur de tâches effectue les tâches lorsque l’ordinateur est inactif. |
|
MultipleInstances |
Lecture/écriture |
Obtient ou définit la stratégie qui définit la façon dont le planificateur de tâches traite plusieurs instances de la tâche. |
|
NetworkSettings |
Lecture/écriture |
Obtient ou définit l’objet de paramètres réseau qui contient un identificateur et un nom de profil réseau. Si la propriété RunOnlyIfNetworkAvailable de TaskSettings a la valeur True et qu’un propfile réseau est spécifié dans la propriété NetworkSettings , la tâche ne s’exécute que si le profil réseau spécifié est disponible. |
|
Priorité |
Lecture/écriture |
Obtient ou définit le niveau de priorité de la tâche. |
|
RestartCount |
Lecture/écriture |
Obtient ou définit le nombre de fois où le planificateur de tâches tente de redémarrer la tâche. |
|
RestartInterval |
Lecture/écriture |
Obtient ou définit une valeur qui spécifie la durée pendant laquelle le planificateur de tâches tente de redémarrer la tâche. |
|
RunOnlyIfIdle |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches n’exécutera la tâche que si l’ordinateur est inactif. |
|
RunOnlyIfNetworkAvailable |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches n’exécute la tâche que lorsqu’un réseau est disponible. |
|
StartWhenAvailable |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches peut démarrer la tâche à tout moment une fois son heure planifiée passée. |
|
StopIfGoingOnBatteries |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que la tâche sera arrêtée si l’ordinateur commence à s’exécuter sur batterie. |
|
WakeToRun |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches réveille l’ordinateur lorsqu’il est temps d’exécuter la tâche. |
|
XmlText |
Lecture/écriture |
Obtient ou définit une définition au format XML des paramètres de tâche. |
Notes
Par défaut, une tâche est arrêtée 72 heures après le début de son exécution. Vous pouvez modifier ce paramètre en modifiant le paramètre ExecutionTimeLimit .
Lors de la lecture ou de l’écriture de code XML pour une tâche, les paramètres de tâche sont définis dans l’élément Settings du schéma Task Scheduler.
Exemples
Pour plus d’informations et un exemple de code pour cet objet de script, consultez Time Trigger Example (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 |
|
| DLL |
|