Settings (taskType)-Element

Artikel
06/12/2023

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]

Siehe auch

Schemaelemente des Aufgabenplanerschemas
Aufgabenplanung