Settings (taskType), élément

Spécifie les paramètres que le planificateur de tâches utilise pour effectuer la tâche.

<xs:element name="Settings"
    type="settingsType"
    minOccurs="0"
 />

L’élément Settings est défini par le type complexe taskType .

Élément parent

Élément	Dérivé de	Description
Tâche	taskType	Spécifie la tâche qui est effectuée par le service Planificateur de tâches.

Éléments enfants

Élément	Type	Description
AllowHardTerminate	boolean	Spécifie que la tâche peut être arrêtée à l’aide de TerminateProcess.
AllowStartOnDemand	boolean	Spécifie que la tâche peut être démarrée à l’aide de la commande Exécuter ou du menu contextuel.
DeleteExpiredTaskAfter	duration	Spécifie la durée pendant laquelle le planificateur de tâches attendra avant de supprimer la tâche après son expiration.
DisallowStartIfOnBatteries	boolean	Spécifie que la tâche ne sera pas démarrée si l’ordinateur est en cours d’exécution sur des batteries.
Activé	boolean	Spécifie que la tâche est activée. La tâche peut être effectuée uniquement lorsque ce paramètre a la valeur True.
ExecutionTimeLimit	duration	Durée autorisée pour terminer la tâche.
Hidden	boolean	Spécifie que la tâche ne sera pas visible dans l’interface utilisateur par défaut.
IdleSettings	idleSettingsType	Spécifie la façon dont le planificateur de tâches effectue les tâches lorsque l’ordinateur est inactif.
MaintenanceSettings	maintenanceSettingsType	Spécifie comment le planificateur de tâches effectue les tâches pendant la maintenance automatique.
MultipleInstancesPolicy	multipleInstancesPolicyType	Spécifie la stratégie qui définit la façon dont le planificateur de tâches traite plusieurs instances de la tâche.
Priorité	priorityType	Spécifie le niveau de priorité de la tâche.
RestartOnFailure	restartType	Spécifie que le planificateur de tâches tentera de redémarrer la tâche en cas d’échec de la tâche pour une raison quelconque.
RunOnlyIfIdle	boolean	Spécifie que la tâche est exécutée uniquement lorsque l’ordinateur est dans un état inactif.
RunOnlyIfNetworkAvailable	boolean	Spécifie que le planificateur de tâches exécute la tâche uniquement lorsqu’un réseau est disponible.
StartWhenAvailable	boolean	Spécifie que le planificateur de tâches peut démarrer la tâche à tout moment une fois son heure planifiée passée.
StopIfGoingOnBatteries (settingsType)	boolean	Spécifie que la tâche sera arrêtée si l’ordinateur est en cours d’exécution.
Volatile	boolean	Spécifie si la tâche est automatiquement désactivée par le planificateur de tâches au démarrage de Windows.
WakeToRun (settingsType)	boolean	Spécifie que le planificateur de tâches sortira l’ordinateur lorsqu’il est temps d’exécuter la tâche.

Notes

Vous pouvez sélectionner un ou plusieurs des éléments enfants référencés ci-dessus.

Pour le développement C++, les informations d’inscription d’une tâche sont spécifiées à l’aide de la propriété Settings de ITaskDefinition.

Pour le développement de scripts, les informations d’inscription d’une tâche sont spécifiées à l’aide de la propriété TaskDefinition.Settings .

Exemples

L’exemple de code XML suivant définit un élément settings qui permet un arrêt physique de la tâche.

<task>
    <Settings>
        <AllowHardTerminate>true</AllowHardTerminate>
        <AllowStartOnDemand>true</AllowStartOnDemand>
    </Settings>
</task>

Pour plus d’informations et un exemple complet du code XML permettant de définir les paramètres de tâche, consultez Time Trigger Example (XML).

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]

Voir aussi

Éléments de schéma du planificateur de tâches

Planificateur de tâches