Partager via


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
Taskschd.tlb
DLL
Taskschd.dll

Voir aussi

Planificateur de tâches

TaskDefinition

NetworkSettings

IdleSettings