Settings (taskType)-Element
Gibt die Einstellungen an, die der Aufgabenplaner zum Ausführen der Aufgabe verwendet.
<xs:element name="Settings"
type="settingsType"
minOccurs="0"
/>
Das Settings-Element wird durch den komplexen Typ taskType definiert.
Übergeordnetes Element
| Element | Abgeleitet von | Beschreibung |
|---|---|---|
| Aufgabe | taskType | Gibt die Aufgabe an, die vom Taskplanerdienst ausgeführt wird. |
Untergeordnete Elemente
| Element | type | Beschreibung |
|---|---|---|
| AllowHardTerminate | boolean | Gibt an, dass der Task mit TerminateProcess beendet werden kann. |
| AllowStartOnDemand | boolean | Gibt an, dass der Task entweder mit dem Befehl Ausführen oder dem Kontextmenü gestartet werden kann. |
| DeleteExpiredTaskAfter | duration | Gibt die Zeitspanne an, die der Taskplaner wartet, bevor der Vorgang nach ablaufen löscht. |
| Nicht zulassenStartIfOnBatteries | boolean | Gibt an, dass die Aufgabe nicht gestartet wird, wenn der Computer mit Batterien ausgeführt wird. |
| Aktiviert | boolean | Gibt an, dass der Task aktiviert ist. Die Aufgabe kann nur ausgeführt werden, wenn diese Einstellung True ist. |
| ExecutionTimeLimit | duration | Zeit, die zum Abschließen der Aufgabe zulässig ist. |
| Ausgeblendet | boolean | Gibt an, dass die Aufgabe auf der Benutzeroberfläche standardmäßig nicht sichtbar ist. |
| IdleSettings | idleSettingsType | Gibt an, wie der Aufgabenplaner Aufgaben ausführt, wenn sich der Computer im Leerlauf befindet. |
| MaintenanceSettings | maintenanceSettingsType | Gibt an, wie der Aufgabenplaner Aufgaben während der automatischen Wartung ausführt. |
| MultipleInstancesPolicy | multipleInstancesPolicyType | Gibt die Richtlinie an, die definiert, wie der Aufgabenplaner mit mehreren Instanzen des Tasks umgeht. |
| Priorität | priorityType | Gibt die Prioritätsebene für den Vorgang an. |
| RestartOnFailure | restartType | Gibt an, dass der Taskplaner versucht, den Task neu zu starten, wenn die Aufgabe aus irgendeinem Grund fehlschlägt. |
| RunOnlyIfIdle | boolean | Gibt an, dass der Task nur ausgeführt wird, wenn sich der Computer im Leerlauf befindet. |
| RunOnlyIfNetworkAvailable | boolean | Gibt an, dass der Taskplaner den Task nur dann ausführen wird, wenn ein Netzwerk verfügbar ist. |
| StartWhenAvailable | boolean | Gibt an, dass der Taskplaner den Task jederzeit starten kann, nachdem die geplante Zeit verstrichen ist. |
| StopIfGoingOnBatteries (settingsType) | boolean | Gibt an, dass die Aufgabe beendet wird, wenn der Computer auf Batterien wechselt. |
| Flüchtige | boolean | Gibt an, ob der Task automatisch vom Taskplaner beim Windows-Start deaktiviert wird. |
| WakeToRun (settingsType) | boolean | Gibt an, dass der Taskplaner den Computer reaktiviert, wenn die Aufgabe ausgeführt werden soll. |
Bemerkungen
Sie können mindestens eines der untergeordneten Elemente auswählen, auf die oben verwiesen wird.
Bei der C++-Entwicklung werden die Registrierungsinformationen eines Vorgangs mithilfe der Settings-Eigenschaft von ITaskDefinition angegeben.
Für die Skriptentwicklung werden die Registrierungsinformationen einer Aufgabe mithilfe der TaskDefinition.Settings-Eigenschaft angegeben.
Beispiele
Im folgenden XML-Codebeispiel wird ein Einstellungselement definiert, das eine harte Beendigung der Aufgabe zulässt.
<task>
<Settings>
<AllowHardTerminate>true</AllowHardTerminate>
<AllowStartOnDemand>true</AllowStartOnDemand>
</Settings>
</task>
Weitere Informationen und ein vollständiges Beispiel für den XML-Code zum Festlegen von Aufgabeneinstellungen finden Sie unter Beispiel für Zeittrigger (XML).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |