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] |