TaskSettings-Objekt

Ein Skriptobjekt, das die Einstellungen bereitstellt, die der Taskplanerdienst zum Ausführen der Aufgabe verwendet.

Member

Das TaskSettings-Objekt verfügt über die folgenden Membertypen:

• Eigenschaften

Eigenschaften

Das TaskSettings-Objekt verfügt über diese Eigenschaften.

Eigenschaft	Zugriffstyp	BESCHREIBUNG
AllowDemandStart	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass der Task mit dem Befehl Ausführen oder dem Kontextmenü gestartet werden kann, oder legt diesen fest.
AllowHardTerminate	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass der Task mit TerminateProcess beendet werden kann, oder legt diesen fest.
Kompatibilität	Lesen/Schreiben	Ruft einen ganzzahligen Wert ab, der angibt, mit welcher Version des Aufgabenplaner eine Aufgabe kompatibel ist, oder legt diesen fest.
DeleteExpiredTaskAfter	Lesen/Schreiben	Ruft die Zeitspanne ab, die der Taskplaner wartet, bevor der Task nach Ablauf des Vorgangs gelöscht wird, oder legt diesen fest.
Nicht zulassenStartIfOnBatteries	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass der Task nicht gestartet wird, wenn der Computer mit Akkubetrieb ausgeführt wird, oder legt diesen fest.
Aktiviert	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe aktiviert ist, oder legt diesen fest. Die Aufgabe kann nur ausgeführt werden, wenn diese Einstellung True ist.
ExecutionTimeLimit	Lesen/Schreiben	Ruft die Zeit ab, die zum Abschließen der Aufgabe zulässig ist, oder legt diesen fest.
Ausgeblendet	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe auf der Benutzeroberfläche nicht sichtbar ist, oder legt diesen fest. Administratoren können diese Einstellung jedoch überschreiben, indem sie einen "master Switch" verwenden, der alle Aufgaben auf der Benutzeroberfläche sichtbar macht.
IdleSettings	Lesen/Schreiben	Ruft die Informationen ab, die angeben, wie der Aufgabenplaner Aufgaben ausführt, wenn sich der Computer im Leerlauf befindet, oder legt diese fest.
MultipleInstances	Lesen/Schreiben	Ruft die Richtlinie ab, die definiert, wie der Aufgabenplaner mit mehreren Instanzen des Tasks umgeht, oder legt diese fest.
NetworkSettings	Lesen/Schreiben	Ruft das Netzwerkeinstellungsobjekt ab, das einen Netzwerkprofilbezeichner und -namen enthält, oder legt es fest. Wenn die RunOnlyIfNetworkAvailable-Eigenschaft von TaskSettingstrue ist und eine Netzwerkpropdatei in der NetworkSettings-Eigenschaft angegeben ist, wird der Task nur ausgeführt, wenn das angegebene Netzwerkprofil verfügbar ist.
Priorität	Lesen/Schreiben	Ruft die Prioritätsebene der Aufgabe ab oder legt diese fest.
RestartCount	Lesen/Schreiben	Ruft die Häufigkeit ab, mit der der Taskplaner versucht, den Task neu zu starten, oder legt diese fest.
RestartInterval	Lesen/Schreiben	Ruft einen Wert ab, der angibt, wie lange der Taskplaner versucht, den Task neu zu starten, oder legt diesen fest.
RunOnlyIfIdle	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner die Aufgabe nur dann ausführen wird, wenn sich der Computer im Leerlauf befindet, oder legt diesen fest.
RunOnlyIfNetworkAvailable	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Task nur dann ausführen wird, wenn ein Netzwerk verfügbar ist, oder legt diesen fest.
StartWhenAvailable	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Task jederzeit starten kann, nachdem die geplante Zeit verstrichen ist, oder legt diesen fest.
StopIfGoingOnBatteries	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass die Aufgabe beendet wird, wenn der Computer mit Akkubetrieb ausgeführt wird, oder legt diesen fest.
WakeToRun	Lesen/Schreiben	Ruft einen booleschen Wert ab, der angibt, dass der Taskplaner den Computer reaktiviert, wenn die Aufgabe ausgeführt werden soll, oder legt diesen fest.
Xmltext	Lesen/Schreiben	Ruft eine XML-formatierte Definition der Aufgabeneinstellungen ab oder legt diese fest.

Bemerkungen

Standardmäßig wird ein Task 72 Stunden nach der Ausführung beendet. Sie können dies ändern, indem Sie die ExecutionTimeLimit-Einstellung ändern.

Beim Lesen oder Schreiben von XML für eine Aufgabe werden die Aufgabeneinstellungen im Einstellungselement des Taskplanerschemas definiert.

Beispiele

Weitere Informationen und ein Codebeispiel für dieses Skriptobjekt finden Sie unter Time Trigger Example (Scripting).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Typbibliothek	Taskschd.tlb
DLL	Taskschd.dll

Siehe auch

Aufgabenplanung

TaskDefinition

NetworkSettings

IdleSettings