Die Aufgabenplanung kann keine E-Mails mehr senden: Benachrichtigung, wenn eine Aufgabe fehlschlägt
Sie möchten eine E-Mail, wenn eine geplante Aufgabe unter Windows fehlschlägt, und die eigene Aktion Send an e-mail (E-Mail senden) der Windows-Aufgabenplanung (Task Scheduler) ist ausgegraut oder liefert einen Fehler. Die Aktion gibt es nicht mehr, der übliche Umweg über das Ereignisprotokoll hat Lücken, und es gibt einen einfacheren Weg zu einer E-Mail oder einer Nachricht in Slack oder Teams, wenn eine Aufgabe fehlschlägt oder nicht läuft.
Warum die Aufgabenplanung Ihnen keine E-Mails mehr schicken kann
Microsoft hat in Windows 8 zwei Aktionen der Aufgabenplanung als veraltet markiert: Send an e-mail und Display a message (Meldung anzeigen). Die Seite „What's New in Task Scheduler“ führt sie unter den veralteten Funktionen auf und empfiehlt, stattdessen ein Skript mit Send-MailMessage auszuführen. Doch Send-MailMessage ist inzwischen selbst als obsolet gekennzeichnet: Microsoft schreibt, dass es keine sichere Verbindung zum Mailserver garantieren kann und nicht verwendet werden sollte. Der offizielle Ersatz für die entfernte Aktion ist also ebenfalls auf dem Weg nach draußen.
Der Umweg, den die meisten Forenantworten nennen, ist eine zweite Aufgabe, ausgelöst On an event (Bei einem Ereignis) aus dem Protokoll Microsoft-Windows-TaskScheduler/Operational, die die Mail sendet. Das funktioniert, mit drei Haken:
- Das Betriebsprotokoll ist standardmäßig aus; Sie schalten es mit Enable All Tasks History (Verlauf für alle Aufgaben aktivieren) ein.
- Ereignis 201 (action completed, Aktion abgeschlossen) wird bei Erfolg wie bei Fehler ausgelöst, der Trigger braucht also einen eigenen XML-Filter auf den Ergebniscode; Ereignis 101 deckt eine Aufgabe ab, die nicht starten konnte. Microsofts eigene Liste dieser Ereignis-IDs stammt aus der Zeit von Windows Server 2008.
- Ein Lauf, der nie stattfand, schreibt überhaupt kein Ereignis. War der PC aus oder konnte sich das Konto der Aufgabe nicht anmelden, löst nichts die E-Mail aus. Forenthreads, die nach „einer Benachrichtigung, wenn die Aufgabe NICHT lief“ fragen, bleiben aus diesem Grund meist unbeantwortet.
Außerdem brauchen Sie weiterhin einen SMTP-Server, der Mail von diesem Rechner annimmt, was viele Firmennetzwerke nicht erlauben.
Die Aufgabe stattdessen an TaskBeacon melden lassen
Statt das Ereignisprotokoll zu beobachten, lassen Sie die Aufgabe ihr eigenes Ergebnis über HTTPS melden. Das folgende PowerShell-Skript führt Ihr Programm aus, wartet darauf und sendet dessen Exit-Code an TaskBeacon; bei einem Fehler fügt es die letzten 20 Zeilen der Ausgabe hinzu. Danach endet es mit demselben Code, sodass das Last Run Result (Ergebnis der letzten Ausführung) der Aufgabenplanung ehrlich bleibt.
# Save as C:\jobs\taskbeacon-run.ps1
# Task Scheduler > Action: Start a program
# Program: powershell.exe
# Arguments: -NoProfile -ExecutionPolicy Bypass -File C:\jobs\taskbeacon-run.ps1 "C:\path\to\program.exe" "arg1" "arg2"
# Runs the program, then reports success or failure from its exit code.
# A .ps1 script as the program is run with powershell.exe -NoProfile -ExecutionPolicy Bypass -File script.ps1
# (an execution policy set by Group Policy still wins over Bypass).
$tb = "https://taskbeacon.io/ping/your-job-id"
$program, $programArgs = $args
# a .ps1 file is not a program Windows can start on its own ("not a valid Win32 application")
if ($program -match '\.ps1$') {
$programArgs = @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', $program) + @($programArgs | Where-Object { $null -ne $_ })
$program = 'powershell.exe'
}
function Send-TaskBeacon($path, $text) {
$send = @{ UseBasicParsing = $true; TimeoutSec = 10; Uri = ($tb + $path) }
if ($text) { $send.Method = 'Post'; $send.ContentType = 'text/plain; charset=utf-8'; $send.Body = [Text.Encoding]::UTF8.GetBytes($text) }
try { Invoke-WebRequest @send | Out-Null }
catch { Write-Host "TaskBeacon ping failed: $_" }
}
Send-TaskBeacon "/start"
# keep arguments that contain spaces together
$argLine = ($programArgs | ForEach-Object { if ($_ -eq '' -or $_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }) -join ' '
# Windows PowerShell 5.1 refuses an empty -ArgumentList: pass it only when there are arguments
$run = @{ FilePath = $program; Wait = $true; PassThru = $true; NoNewWindow = $true; ErrorAction = 'Stop' }
if ($argLine) { $run.ArgumentList = $argLine }
# the program's output goes to temporary files: shown below, and its last 20 lines go with a failure
$out = [IO.Path]::GetTempFileName(); $err = [IO.Path]::GetTempFileName()
$run.RedirectStandardOutput = $out; $run.RedirectStandardError = $err
$code = 1
$note = ''
try {
$p = Start-Process @run
if ($null -ne $p.ExitCode) { $code = $p.ExitCode }
} catch { $note = "Could not start ${program}: $_"; Write-Host $note }
Get-Content -LiteralPath $out, $err -ErrorAction SilentlyContinue
$tail = ''
if ($code -ne 0) {
$lines = @(Get-Content -LiteralPath $out, $err -Tail 20 -ErrorAction SilentlyContinue) + @($note)
$tail = ($lines | Where-Object { $_ } | ForEach-Object { if ($_.Length -gt 300) { $_.Substring(0, 300) } else { $_ } }) -join "`n"
}
# the exit code goes at the end of the address: /0 = OK, any other number = failed
Send-TaskBeacon "/$code" $tail
Remove-Item -LiteralPath $out, $err -ErrorAction SilentlyContinue
exit $code # not 0 when it failed, so Task Scheduler shows the failure tooIn der App gibt Ihnen der Tab Code Ihres Jobs diesen Code mit der eigenen Adresse des Jobs statt your-job-id, und Sie können die Teile abwählen, die Sie nicht brauchen.
Setzen Sie in der Aktion der Aufgabe Program (Programm) auf powershell.exe und Arguments (Argumente) wie im Kommentar oben, mit Ihrem Programm und seinen Argumenten am Ende. Mehr braucht es auf dem Rechner nicht: keinen SMTP-Server, kein Mailprofil, keine zweite Aufgabe.
Was Sie bekommen
- Eine E-Mail, wenn die Aufgabe fehlschlägt, mit dem Exit-Code und den letzten Zeilen der Ausgabe. Dieselbe Benachrichtigung kann an Slack, Microsoft Teams, Discord, Google Chat, ntfy oder einen Webhook gehen, und an die Adressen von Kollegen (siehe Benachrichtigungen).
- Eine E-Mail, wenn die Aufgabe nicht läuft: Stellen Sie den Zeitplan des Jobs wie den Trigger der Aufgabe ein (täglich um 06:00, an Werktagen, alle 2 Stunden …), und wenn bis zur geplanten Zeit plus Karenzzeit kein Ping kommt, wird der Job Missed (verpasst). Das ist der Fall, den der Trigger auf das Ereignisprotokoll nicht sehen kann.
- Eine E-Mail, wenn sie viel länger läuft als üblich (Late, verspätet), und eine, wenn sie wieder OK ist.
Gibt das Programm auch bei einem Fehler 0 zurück, kann ein Wrapper das nicht erkennen; melden Sie dann aus dem Skript heraus, zum Beispiel mit dem Code für Python oder R. Warum das passiert, steht unter Aufgabenplanung zeigt 0x0, aber das Skript ist fehlgeschlagen.
Ohne TaskBeacon
Aktivieren Sie den Aufgabenverlauf, legen Sie eine Aufgabe an, die bei Ereignis 201 von Microsoft-Windows-TaskScheduler/Operational auslöst, mit einem XML-Filter auf einen ResultCode ungleich 0 und den Namen der Aufgabe, und lassen Sie sie ein PowerShell-Skript ausführen, das über Ihren SMTP-Server Mail sendet (mit einer Mail-Bibliothek, da Send-MailMessage obsolet ist). Ergänzen Sie einen zweiten Trigger auf Ereignis 101 für Aufgaben, die nicht starten. Das deckt Fehler auf diesem einen Rechner ab. Für Läufe, die nie stattfinden, brauchen Sie etwas außerhalb des Rechners, das ein Signal erwartet – genau das ist ein Heartbeat-Check.
Claude oder ChatGPT mit TaskBeacon verbunden? Fragen Sie: „Was ist letzte Nacht fehlgeschlagen, und warum?“, und die Antwort kommt aus Ihren Jobs. So funktioniert das.
Verwandte Themen
In den Docs: PowerShell (Aufgabenplanung) · Benachrichtigungen · Zeitpläne.
- Aufgabenplanung zeigt Last Run Result 0x0, aber das Skript ist fehlgeschlagenLast Run Result 0x0 bedeutet nur, dass das gestartete Programm 0 zurückgegeben hat.
- Erfahren, wenn ein geplanter Job gar nicht gelaufen istEin Lauf, der nie stattfand, hinterlässt keinen Fehler, der eine Benachrichtigung auslösen könnte.
- Fehler in PowerShell-Skripten und der Exit-Code in der AufgabenplanungNicht abbrechende Fehler hinterlassen Exit-Code 0; -Command presst Codes auf 0 oder 1 zusammen.
Der Einstieg in TaskBeacon ist kostenlos, derzeit mit allen Funktionen und ohne Kreditkarte. Legen Sie einen Job an, fügen Sie den Code ein, und der erste Ping erscheint auf der Seite des Jobs.
Kostenlos starten Live-Demo ansehenQuellen
- Microsoft Learn: Neuerungen in der Aufgabenplanung (sendEmail und showMessage seit Windows 8 veraltet) (31. Mai 2018, aktualisiert am 11. März 2025; weiterhin die aktuelle Seite)
- Microsoft Learn: Send-MailMessage (als veraltet markiert) (18. Juni 2024, aktualisiert am 16. Juni 2026)
- Microsoft Learn (frühere Versionen): Ereignis-IDs der Aufgabenplanung, z. B. 101 Aufgabenstart fehlgeschlagen (etwa 2009, alt: keine aktuelle Seite listet diese IDs auf)
- Microsoft Q&A: E-Mail-Benachrichtigungen bei Fehlern von Aufgaben in der Aufgabenplanung einrichten (die Option „E-Mail senden“ ist veraltet) (26. Oktober 2023, alt: ein Zeichen für Bedarf)
- Microsoft Q&A: Ein Skript planen und E-Mail-Benachrichtigung über die Aufgabenplanung einrichten (2024-04-27)
Diese Seite wurde am 19. November 2026 mit ihren Quellen abgeglichen. Menüs und Grenzen anderer Produkte ändern sich; wenn hier etwas nicht mehr stimmt, schreiben Sie an support@taskbeacon.io.