Partager via


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