Batch(.bat)
任意のジョブを包む .bat ラッパーです。Windows 10 と 11 に標準搭載の curl.exe を使います。ジョブの出力は一時ファイルに保存され、失敗したときはその最後の 20 行がアラートに添えられます。
コード
これは Code(コード)タブが生成するコードです(開始とエラー にチェックを入れた状態)。アプリでは、あなたのジョブ専用のアドレスがすでに入っています。
@echo off
REM Save as C:\jobs\taskbeacon-run.bat
REM Task Scheduler > Action: Start a program
REM Program: C:\jobs\taskbeacon-run.bat
REM Runs your job, then reports success or failure from its exit code.
set "TB=https://taskbeacon.io/ping/your-job-id"
curl.exe -fsS -m 10 "%TB%/start" >nul
REM --- your job here (a program, a script, another .bat with call): replace the path ---
REM its output goes to a temporary file: shown below, and its last 20 lines go with a failure
set "TB_LOG=%TEMP%\taskbeacon-%RANDOM%.log"
call "C:\path\to\your-job.bat" > "%TB_LOG%" 2>&1
set TB_RC=%ERRORLEVEL%
type "%TB_LOG%"
type nul > "%TB_LOG%.tail"
if not "%TB_RC%"=="0" powershell.exe -NoProfile -Command "Get-Content -LiteralPath $env:TB_LOG -Tail 20 | ForEach-Object { if ($_.Length -gt 300) { $_.Substring(0, 300) } else { $_ } }" > "%TB_LOG%.tail" 2>nul
REM the exit code goes at the end of the address: /0 = OK, any other number = failed
curl.exe -fsS -m 10 --data-binary "@%TB_LOG%.tail" -H "Content-Type: text/plain" "%TB%/%TB_RC%" >nul
del "%TB_LOG%" "%TB_LOG%.tail" 2>nul
exit /b %TB_RC%仕組み
.bat はジョブの開始時に /start を ping し、終了時には末尾に終了コードを付けたアドレスを ping します:/0 は OK、それ以外の数字は失敗で、出力の最後の 20 行と一緒に送られます。行数は送りません。
一部を省きたい場合は、Code タブでオプションのチェックを外してください。出力を送らず、エラーか終了コードだけを送るには Send output lines(出力行を送信)のチェックを外します。報告できる内容もご覧ください。
スケジュールで実行する
コードを C:\jobs\taskbeacon-run.bat として保存し、your job here と書かれた場所にジョブのコマンドを入れて、タスクを作成します(コマンド プロンプトで 1 行)。
schtasks /Create /TN "Nightly export" /SC DAILY /ST 02:00 /TR "C:\jobs\taskbeacon-run.bat"
ジョブが相対パスを使う場合は、Task Scheduler で Start in(開始)にジョブのフォルダーを設定してください。
よくある問題
- 失敗したジョブが OK と表示される。 ラッパーは
callの後のコマンドの終了コードを報告します。それが別の .bat の場合、問題が起きたときはexit /b 1(または別の数値)で終わる必要があります。.bat は最後のコマンドのコードで終了します。 - curl.exe が見つからない。 Windows 10 と 11 には標準で入っています。古い Windows では
curl.exeのフルパスを指定してください。 - % 記号が消える。 .bat の中では、文字としての
%は%%と書く必要があります。 - 手動では動くが、スケジュールでは動かない。 Run whether user is logged on or not(ユーザーがログオンしているかどうかにかかわらず実行する)にチェックを入れ、割り当てたドライブ文字ではなく UNC パス(
\server\share\…)を使ってください。
ユースケース: Task Scheduler の Last Run Result は 0x0 なのに、スクリプトは失敗した。その他のご質問: FAQ