Fehler in geplanten Aufgaben finden mit PowerShell

Get-ScheduledTaskInfo

Einige Basisdaten zu einer geplanten Aufgabe kann man mit dem Cmdlet Get-ScheduledTaskInfo abrufen. Dieses verlangt als Argument den Namen der Task, der auch den Pfad enthalten muss. Diesen kann man nach diesem Muster ermitteln:

Get-ScheduledTask -TaskName "*Defender*" | select TaskName, TaskPath

Der obige Aufruf würde alle geplanten Aufgaben für Microsoft Defender anzeigen. Der Ausgabe des Befehls entnimmt man dann die Daten für den Aufruf von Get-ScheduledTaskInfo. In unserem Defender-Beispiel könnte dieser so aussehen:

Get-ScheduledTaskInfo -TaskName "\Microsoft\Windows\Windows Defender\Windows Defender Scheduled Scan"

Aus dem Output des Cmdlets geht hervor, wann die Aufgabe das letzte Mal ausgeführt wurde und welchen Code sie zurückgeliefert hat. Jeder Wert ungleich null deutet auf ein Problem hin. Eine Übersicht über diverse Fehlercodes findet sich auf Microsofts Website.

Der offensichtliche Nachteil dieses Cmdlets besteht darin, dass es nur Auskunft über die letzte Ausführung einer Task gibt. Eine mögliche Fehlermeldung, die in das Logfile geschrieben wurde, sieht man damit auch nicht.

Log auswerten mit Get-WinEvent

Ausführlichere Informationen zu aufgetretenen Fehlern erhält man über die Auswertung des Eventlogs. Zuständig dafür ist das Logfile

Get-WinEvent -LogName "microsoft-windows-taskscheduler/operational"

Dieser Befehl gibt alle Ereignisse für sämtliche Tasks aus, was man bei einer Fehlersuche aber normalerweise nicht möchte. Daher kann man die Logs mit Hilfe einer Hash-Tabelle filtern:

Get-WinEvent -MaxEvents 500 -FilterHashtable @{    LogName='microsoft-windows-taskscheduler/operational'    Level=2    StartTime="01.02.2023" }  | where message -Like "*Update*" | Format-List

In diesem Beispiel erhalten wir bis zu 500 Einträge, die nach dem 01.02.2023 geschrieben wurden, die einen Fehler dokumentieren (Level 2) und in der Nachricht den Begriff Update enthalten.

Eine bestimmte Task kann man nur über den Inhalt der Nachricht ermitteln, was aber über den Hashtable nicht möglich ist. Diesem Zweck dient daher der anschließende Filter mittels Where-Object, der im obigen Aufruf nach der Zeichenkette "Update" sucht.

Zusammenfassung

Wenn eine geplante Aufgabe nicht läuft wie erwartet, konsultiert man am besten erst das Cmdlet Get-ScheduledTaskInfo. Es liefert ein paar Infos zur letzten Ausführung, darunter den Return-Code.

Wenn diese nicht ausreichen, dann wirft man einen Blick in das Eventlog. Eine Filterung nach bestimmten Aufgaben ist mit PowerShell indes nicht ohne weiteres möglich. Vielmehr muss man dazu den Inhalt der Nachricht durchsuchen.