Freigeben über


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]

Siehe auch

Schemaelemente des Aufgabenplanerschemas

Aufgabenplanung