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

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