PowerShell (Aufgabenplanung)
Ein PowerShell-Wrapper um ein beliebiges Programm: Er meldet anhand des Exit-Codes des Programms. Die Ausgabe des Programms wird in einer temporären Datei gehalten; bei einem Fehler gehen ihre letzten 20 Zeilen mit der Benachrichtigung mit.
Der Code
Das ist der Code, den der Tab Code erzeugt (mit Start und Fehler angehakt). In der App enthält er bereits die eigene Adresse Ihres Jobs.
# 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 tooSo funktioniert es
Der Wrapper pingt /start, wenn das Programm beginnt, und an seinem Ende die Adresse mit dem Exit-Code am Schluss: /0 ist OK, jede andere Zahl ein Fehler, gesendet mit den letzten 20 Zeilen der Ausgabe. Er sendet keine Zeilenzahl.
Entfernen Sie auf dem Tab Code Haken bei Optionen, um Teile wegzulassen; entfernen Sie den Haken bei Send output lines (Ausgabezeilen senden), um keine Ausgabe zu senden, nur den Fehler oder Exit-Code. Siehe was gemeldet werden kann.
Die Aufgabe über die Befehlszeile anlegen
Speichern Sie das Skript oben als C:\jobs\taskbeacon-run.ps1 und legen Sie dann eine Aufgabe an, die es mit Ihrem Programm ausführt (eine Zeile, in einer Eingabeaufforderung):
schtasks /Create /TN "Nightly export" /SC DAILY /ST 02:00 /TR "powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\jobs\taskbeacon-run.ps1 C:\jobs\export.exe"
Der Wrapper startet das Programm, wartet darauf und meldet das Ergebnis mit dessen Exit-Code in der Adresse (/0 ist OK, /1 oder jede andere Zahl ein Fehler), bei einem Fehler mit den letzten 20 Zeilen der Ausgabe. Er endet mit demselben Exit-Code, sodass Last Run Result (Letztes Ausführungsergebnis) in der Aufgabenplanung (Task Scheduler) mit TaskBeacon übereinstimmt.
Ein PowerShell-Skript als Job. Geben Sie dem Wrapper die .ps1-Datei als Programm; er führt sie selbst mit powershell.exe -NoProfile -ExecutionPolicy Bypass -File script.ps1 aus (Windows kann eine .ps1 nicht von sich aus starten: %1 is not a valid Win32 application):
schtasks /Create /TN "Nightly cleanup" /SC DAILY /ST 03:00 /TR "powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\jobs\taskbeacon-run.ps1 C:\jobs\cleanup.ps1"
Um eine bestehende Aufgabe einzupacken, öffnen Sie sie in der Aufgabenplanung → Actions (Aktionen) → Edit (Bearbeiten): Programm powershell.exe, Argumente wie im Kommentar am Anfang des Skripts, mit Pfad und Argumenten Ihres Programms am Ende.
Warum der Exit-Code lügt
Die Aufgabenplanung kennt nur den Exit-Code des Programms, das sie gestartet hat. Drei Dinge führen sie in die Irre:
- Ein Wrapper, der ihn verdeckt. Eine
.bat-Datei endet mit dem Code ihres letzten Befehls, also zeigt ein fehlschlagendes Programm, auf das ein erfolgreichescopyfolgt,0x0. - Ein Programm, das immer 0 zurückgibt. Stata im Batch-Modus und viele hauseigene Werkzeuge enden nach einem Fehler mit 0. Verwenden Sie den Code für die jeweilige Sprache auf TaskBeacon (Stata, R, Python …), der den Fehler von innen meldet.
- Gar kein Lauf. Ist der PC aus, im Ruhezustand oder das Passwort der Aufgabe abgelaufen, gibt es keinen Exit-Code und keinen Hinweis. TaskBeacon zeigt den Job als „Missed“ (verpasst).
Häufige Werte für Last Run Result: 0x0 Erfolg, 0x1 das Programm gab 1 zurück (oft ein allgemeiner Fehler), 0x41301 die Aufgabe läuft noch, 0x41303 sie ist noch nicht gelaufen.
Eine Zahl melden
Ein Wrapper sieht nur den Exit-Code. Um eine Zeilenzahl zu senden, verwenden Sie den Code für die eigene Sprache Ihres Programms oder pingen Sie aus dem Programm selbst mit ?rows=.
Häufige Probleme
- Läuft von Hand, aber nicht nach Zeitplan. Aktivieren Sie Run whether user is logged on or not (Unabhängig von der Benutzeranmeldung ausführen) und verwenden Sie UNC-Pfade statt verbundener Laufwerksbuchstaben.
- „running scripts is disabled on this system“. Lassen Sie
-ExecutionPolicy Bypassin den Argumenten; es gilt nur für diesen Lauf. Eine per Gruppenrichtlinie gesetzte Ausführungsrichtlinie hat Vorrang: Prüfen Sie das mitGet-ExecutionPolicy -List, und wenn MachinePolicy oder UserPolicy gesetzt ist, fragen Sie die IT. - „%1 is not a valid Win32 application“. Eine
.ps1wurde als Programm gestartet. Verwenden Sie den Wrapper (er kommt mit einer .ps1 zurecht) oder starten Sie sie alspowershell.exe -NoProfile -ExecutionPolicy Bypass -File script.ps1. - Ein Pfad mit Leerzeichen. Setzen Sie ihn in den Argumenten der Aufgabe in Anführungszeichen:
"C:\Program Files\Tool\tool.exe".
Anwendungsfälle: Aufgabenplanung zeigt Last Run Result 0x0, aber das Skript ist fehlgeschlagen · Die Aufgabenplanung kann keine E-Mails mehr senden: Benachrichtigung, wenn eine Aufgabe fehlschlägt · Fehler in PowerShell-Skripten und der Exit-Code in der Aufgabenplanung. Weitere Fragen: FAQ.