Get-ScheduledTaskRunTime

EulandaXtools — Funktionsreferenz

Get-ScheduledTaskRunTime

ÜBERSICHT

Ermittelt Laufzeiten geplanter Aufgaben inkl. Erfolg/Fehlerstatus und kann optional das TaskScheduler-Operational-Log aktivieren.

SYNTAX

Get-ScheduledTaskRunTime [[-TaskName] <string>] [[-Count] <int>] [-Force] [<CommonParameters>]

BESCHREIBUNG

Liest Start- (EventID 100) und Abschluss-Events (EventID 102) aus dem Windows-Eventlog "Microsoft-Windows-TaskScheduler/Operational".

Die Zuordnung der Events erfolgt über die InstanceId der Aufgabe. Zusätzlich wird der ResultCode ausgewertet:

0 = Success

!=0 = Error

Mit -Force kann das Protokoll automatisch aktiviert werden, falls es deaktiviert ist. Nach dem Aktivieren ist die Ausgabe in der Regel zunächst leer, bis geplante Aufgaben erneut ausgeführt und entsprechende Logeinträge erzeugt wurden.

Force benötigt administrative Rechte.

PARAMETER

-TaskName

Type: string

Vollständiger Aufgabenname inkl. führendem Backslash.

-Count

Type: int
Default: 20

Anzahl der letzten Läufe, die zurückgegeben werden sollen.

-Force

Type: switch

Aktiviert das TaskScheduler-Operational-Log automatisch, falls es deaktiviert ist (Administratorrechte erforderlich).

BEISPIELE

#Letzte 20 Läufe anzeigen
Get-ScheduledTaskRunTime
#Log bei Bedarf aktivieren
Get-ScheduledTaskRunTime -Force
#Andere Aufgabe prüfen
Get-ScheduledTaskRunTime -TaskName '\Microsoft\Windows\DiskCleanup\SilentCleanup' -Count 5
# Prüft wie oft WordPress Abrufe gestartet wurden und wie lange jeder Job dauerte
Get-ScheduledTaskRunTime -TaskName '\Eulanda\Wordpress ORDER nach EULANDA' -Count 5