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

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