WeeklyTrigger-Objekt

Skriptobjekt, das einen Trigger darstellt, der eine Aufgabe basierend auf einem wöchentlichen Zeitplan startet. Beispielsweise beginnt die Aufgabe jede Woche oder jede zweite Woche um 8:00 Uhr an einem bestimmten Wochentag.

Member

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

• Eigenschaften

Eigenschaften

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

Eigenschaft	Zugriffstyp	BESCHREIBUNG
DaysOfWeek	Lesen/Schreiben	Ruft die Wochentage ab, an denen der Task ausgeführt wird, oder legt diese fest.
Aktiviert	Lesen/Schreiben	Geerbt vom Trigger-Objekt . Ruft einen booleschen Wert ab, der angibt, ob der Trigger aktiviert ist, oder legt diesen fest.
EndBoundary	Lesen/Schreiben	Geerbt vom Trigger-Objekt . Ruft das Datum und die Uhrzeit der Deaktivierung des Triggers ab oder legt dieses fest. Der Trigger kann den Task nicht starten, nachdem er deaktiviert wurde.
ExecutionTimeLimit	Lesen/Schreiben	Geerbt vom Trigger-Objekt . Ruft die maximale Zeit ab, die der vom Trigger gestartete Task ausführen darf, oder legt diesen fest.
Id	Lesen/Schreiben	Geerbt vom Trigger-Objekt . Ruft den Bezeichner für den Trigger ab oder legt diese fest.
RandomDelay	Lesen/Schreiben	Ruft eine Verzögerungszeit ab, die der Startzeit des Triggers zufällig hinzugefügt wird, oder legt diese fest.
Wiederholen	Lesen/Schreiben	Geerbt vom Trigger-Objekt . Ruft ab oder legt fest, wie oft der Task ausgeführt wird und wie lange das Wiederholungsmuster wiederholt wird, nachdem der Task gestartet wurde.
StartBoundary	Lesen/Schreiben	Geerbt vom Trigger-Objekt . Ruft das Datum und die Uhrzeit ab, zu dem der Trigger aktiviert wird, oder legt dieses fest.
type	Schreibgeschützt	Geerbt vom Trigger-Objekt . Ruft den Typ des Triggers ab.
WeeksInterval	Lesen/Schreiben	Ruft das Intervall zwischen den Wochen im Zeitplan ab oder legt es fest.

Bemerkungen

Die Tageszeit, zu der der Task gestartet wird, wird von der StartBoundary-Eigenschaft festgelegt.

Beim Lesen oder Schreiben ihres eigenen XML-Codes für eine Aufgabe wird ein wöchentlicher Trigger mithilfe des ScheduleByWeek-Elements des Taskplanerschemas angegeben.

An dem Tag, an dem die Sommerzeit (DST) in einem Jahr beginnt, für eine pazifische Zeitzone (zeitverschiebung von 02:00 UHR auf 03:00 Uhr in 2022) wird jeder Vorgang, der zwischen 02:00 Uhr und 02:59:59:99 Uhr ausgeführt wird, zum frühesten möglichen Zeitpunkt ausgeführt, der an diesem Tag vorhanden ist, d. h. um 03:00 Uhr. Dies gilt für alle DST-Zeitzonen basierend auf den verschiedenen Zeiten, zu denen sie die DST beobachten.

Betrachten Sie eine wöchentliche Aufgabe, die jeden Sonntag von 2022 um 2:30 Uhr in der pazifischen Zeitzone ausgeführt wird, sodass die nächste Laufzeit am 13. März 2022 um 2:30 Uhr ist. Da 2:30 AM eine Zeit ist, die am 13. März 2022 nicht vorhanden ist, wird die Aufgabe stattdessen um 3:00 Uhr ausgeführt. An anderen Sonntagen im Jahr läuft die Aufgabe wie gewohnt um 2:30 Uhr.

Beispiele

Weitere Informationen und ein Codebeispiel für dieses Skriptingobjekt finden Sie unter Wöchentliches Triggerbeispiel (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

Trigger

Triggercollection

TriggerCollection.Create