PowerShell (Task Scheduler)
Un wrapper de PowerShell alrededor de cualquier programa: informa según el código de salida del programa. La salida del programa se guarda en un archivo temporal; si falla, sus últimas 20 líneas van con la alerta.
El código
Este es el código que genera la pestaña Code (código) (con inicio y errores marcado). En la app ya contiene la dirección propia de tu job.
# 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 tooCómo funciona
El wrapper envía un ping a /start cuando el programa empieza y, cuando termina, a la dirección con su código de salida al final: /0 es OK, cualquier otro número es un fallo, enviado con las últimas 20 líneas de salida. No envía número de filas.
Desmarca opciones en la pestaña Code para dejar partes fuera; desmarca Send output lines (enviar líneas de salida) para no enviar ninguna salida, solo el error o el código de salida. Consulta qué se puede informar.
Crear la tarea desde la línea de comandos
Guarda el script de arriba como C:\jobs\taskbeacon-run.ps1 y luego crea una tarea que lo ejecute con tu programa (una línea, en un Símbolo del sistema):
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"
El wrapper inicia el programa, espera a que termine y reporta el resultado con su código de salida en la dirección (/0 es OK, /1 o cualquier otro número es un fallo), con las últimas 20 líneas de la salida cuando falló. Termina con el mismo código de salida, así que el Last Run Result (resultado de la última ejecución) de Task Scheduler coincide con TaskBeacon.
Un script de PowerShell como job. Dale al wrapper el archivo .ps1 como programa; él mismo lo ejecuta con powershell.exe -NoProfile -ExecutionPolicy Bypass -File script.ps1 (Windows no puede iniciar un .ps1 por sí solo: %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"
Para envolver una tarea existente, ábrela en Task Scheduler → Actions → Edit: Program powershell.exe, Arguments como en el comentario al principio del script, con la ruta y los argumentos de tu programa al final.
Por qué el código de salida miente
Task Scheduler solo conoce el código de salida del programa que inició. Tres cosas lo engañan:
- Un wrapper que lo oculta. Un archivo
.battermina con el código de su último comando, así que un programa que falla seguido de uncopyque funciona muestra0x0. - Un programa que siempre devuelve 0. Stata en modo batch y muchas herramientas internas terminan con 0 después de un error. Usa en TaskBeacon el código del propio lenguaje (Stata, R, Python …), que reporta el error desde dentro.
- Ninguna ejecución. Cuando el PC está apagado, suspendido o la contraseña de la tarea caducó, no hay código de salida ni aviso. TaskBeacon muestra el job como Missed (no ejecutado).
Valores habituales de Last Run Result: 0x0 éxito, 0x1 el programa devolvió 1 (a menudo un error genérico), 0x41301 la tarea todavía se está ejecutando, 0x41303 todavía no se ha ejecutado.
Reportar un número
Un wrapper solo ve el código de salida. Para enviar un número de filas, usa el código para el lenguaje de tu programa, o envía el ping desde el propio programa con ?rows=.
Problemas frecuentes
- Funciona a mano, pero no según el horario. Marca Run whether user is logged on or not (Ejecutar tanto si el usuario inició sesión como si no) y usa rutas UNC en lugar de letras de unidades asignadas.
- "running scripts is disabled on this system". Deja
-ExecutionPolicy Bypassen los argumentos; solo se aplica a esta ejecución. Una directiva de ejecución definida por Group Policy tiene prioridad sobre ella: compruébalo conGet-ExecutionPolicy -Listy, si MachinePolicy o UserPolicy están definidas, pregunta a TI. - "%1 is not a valid Win32 application". Se inició un
.ps1como si fuera un programa. Usa el wrapper (sabe manejar un .ps1), o inícialo comopowershell.exe -NoProfile -ExecutionPolicy Bypass -File script.ps1. - Una ruta con espacios. Ponla entre comillas en los argumentos de la tarea:
"C:\Program Files\Tool\tool.exe".
Casos de uso: Task Scheduler Last Run Result 0x0, pero el script falló · El Programador de tareas ya no puede enviar correos: recibe una alerta cuando una tarea falla · Errores de scripts de PowerShell y el código de salida en Task Scheduler. Más preguntas: preguntas frecuentes.