Objet TaskSettings
Objet de script qui fournit les paramètres utilisés par le service de Planificateur de tâches pour effectuer la tâche.
Membres
L’objet TaskSettings possède les types de membres suivants :
Propriétés
L’objet TaskSettings a 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 quelle version de Planificateur de tâches une tâche est compatible. |
| DeleteExpiredTaskAfter |
Lecture/écriture |
Obtient ou définit la durée d’attente de la Planificateur de tâches avant la suppression de la tâche après son expiration. |
| DisallowStartIfOnBatteries |
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 exécutée que lorsque ce paramètre a la valeur true. |
| ExecutionTimeLimit |
Lecture/écriture |
Obtient ou définit la durée autorisée pour terminer 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 à l’aide d’un « commutateur maître » 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 exécute des tâches lorsque l’ordinateur est dans un état d’inactivité. |
| MultipleInstances |
Lecture/écriture |
Obtient ou définit la stratégie qui définit la façon dont le Planificateur de tâches gère plusieurs instances de la tâche. |
| NetworkSettings |
Lecture/écriture |
Obtient ou définit l’objet 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 s’exécute uniquement 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 tentatives de redémarrage de la tâche par le Planificateur de tâches. |
| RestartInterval |
Lecture/écriture |
Obtient ou définit une valeur qui spécifie la durée pendant laquelle l’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 exécutera la tâche uniquement si l’ordinateur est dans un état inactif. |
| RunOnlyIfNetworkAvailable |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que le Planificateur de tâches exécutera la tâche uniquement lorsqu’un réseau est disponible. |
| StartWhenAvailable |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que la Planificateur de tâches peut démarrer la tâche à tout moment une fois l’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 à fonctionner sur batterie. |
| WakeToRun |
Lecture/écriture |
Obtient ou définit une valeur booléenne qui indique que le Planificateur de tâches met l’ordinateur en éveil lorsqu’il est temps d’exécuter la tâche. |
| XmlText |
Lecture/écriture |
Obtient ou définit une définition XML des paramètres de tâche. |
Notes
Par défaut, une tâche sera arrêtée 72 heures après son démarrage. Vous pouvez modifier ce paramètre en modifiant le paramètre ExecutionTimeLimit .
lors de la lecture ou de l’écriture de données XML pour une tâche, les paramètres de tâche sont définis dans l’élément Paramètres du schéma Planificateur de tâches.
Exemples
Pour plus d’informations et pour obtenir un exemple de code pour cet objet de script, consultez exemple de déclenchement temporel (script).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau Vista uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2008 [ applications de bureau uniquement] |
| Bibliothèque de types |
|
| DLL |
|