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

Voir aussi

Planificateur de tâches

TaskDefinition

NetworkSettings

IdleSettings