Task Scheduler の Last Run Result は 0x0 なのに、スクリプトは失敗した
Windows の Task Scheduler(タスク スケジューラ)には Last Run Result: The operation completed successfully. (0x0)(前回の実行結果: この操作を正しく終了しました。(0x0))と表示されているのに、エクスポートは空で、レポートも更新されていない。0x0 は見た目ほど多くを意味しません。よくある 3 つの理由で事実と食い違い、本当の結果は簡単に報告できます。
0x0 が本当に意味すること
Task Scheduler はプログラムを起動し、終了時に返される数値、つまり終了コードを待ちます。0x0 はその数値の 16 進表記で、0 です。慣例として成功を意味します。0x1 はプログラムが 1 を返したことを意味し、通常は一般的なエラーです。いくつかの値は Task Scheduler 独自のものです。0x41301 はタスクがまだ実行中、0x41303 はまだ一度も実行されていないことを示します(Microsoft はこれらを Task Scheduler のエラー定数および成功定数として記載しています)。
つまり 0x0 は「ジョブがうまくいった」とは言っていません。「起動したプログラムが 0 を返した」と言っているだけです。それが知りたかったことと違ってしまう理由は 3 つあります。
- ラッパーがコードを隠す。
.batファイルは終了時に設定されている errorlevel で終わり、通常それは最後のコマンドのものです。本来のジョブが失敗しても、その後のcopyやechoが成功すれば、バッチファイルは 0 で終わります。ジョブの直後に明示的なexit /b %ERRORLEVEL%を置いたときだけ、失敗が引き継がれます。 - プログラムがエラーの後に 0 を返す。 バッチモードの Stata がそうですし、多くの社内ツールや、終了しないエラー(non-terminating error)を出した PowerShell スクリプトも同様です(PowerShell の終了コードを参照)。
- ジョブは「動いた」が、役に立つことは何もしなかった。 1 行も返さないクエリ、昨日のソースファイル、空のリストを返した API。どれも 0 で終了します。
そしてタスクがまったく実行されなかった場合、新しい結果はありません。列には前回の結果が表示されたままで、それは 0x0 かもしれません。
本当の結果を報告する
最も確実な対策は、ジョブの中から、そのジョブ自身の言語で報告することです。Python、R、Stata などは、自分でエラーメッセージ付きの /fail を送ります。プログラムを変更できない場合は、ラッパーで包みます。以下のバッチファイルはジョブを起動し、その終了コードを保持し、最後に ping アドレスの末尾に付けて TaskBeacon に報告します。/0 なら OK、それ以外の数値は失敗で、出力の最後の 20 行と一緒に送られます。
@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%アプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
Task Scheduler で、タスクの操作の対象をジョブではなくこの .bat にしてください。最後が exit /b %TB_RC% なので、Last Run Result は TaskBeacon の表示と一致するようになります。PowerShell を使いたい場合は、PowerShell ラッパーがどの .exe にも同じことをします。
得られるもの
- Failed(失敗): ジョブが終了した瞬間に、終了コードと出力の最後の数行付きで、メールや Slack、Teams に届きます。
- Missed(未実行): 予定時刻に猶予時間を加えた時刻までにタスクが実行されなかったとき。Task Scheduler が昨日の 0x0 を表示し続けるケースです。
- Late(遅延): ジョブが開始したものの、いつもよりずっと長くかかっているとき。
「動いたが何もしなかった」ケースには、終了コードだけでは足りません。ジョブが行数などの数値を送る必要があります。0 行、またはいつもよりずっと少ない場合を参照してください。
TaskBeacon を使わない場合
ラッパーを直します。すべてのバッチファイルで、重要なステップの直後に exit /b %ERRORLEVEL% を置き、プログラムが失敗時に 0 以外のコードを返すようにします。そのうえで Last Run Result 列を確認するか、タスクの履歴を有効にしてイベント ビューアーでそのタスクのイベントを探します。これで失敗は見えるようになりますが、見に行った人にしか見えません。通知については スケジュールタスクが失敗したときにメールを送るを参照してください。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
ドキュメント:Batch(.bat) · PowerShell(Task Scheduler) · ping に終了コード
- Task Scheduler はもうメールを送れません:タスクが失敗したときにアラートを受け取る標準のメール送信操作はなくなり、イベントで起動するタスクは、起きなかった実行を見逃します。
- PowerShell スクリプトのエラーと Task Scheduler の終了コード終了しないエラーでは終了コードが 0 のまま。-Command はコードを 0 か 1 にまとめてしまいます。
- バッチモードで Stata の do ファイルが失敗したときにアラートを受け取るStata の /e や -b は、do ファイルの失敗をスケジューラーに伝えません。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- Microsoft Learn:Task Scheduler のエラー定数と成功定数(0x41301、0x41303 …) (2024-10-29)
- Microsoft Learn: exit コマンド(exit /b で errorlevel を設定) (2023-10-12)
- Microsoft Q&A:Python スクリプトを実行する Task Scheduler の (0x1) エラーを直す方法 (2023年8月28日、古い:需要の表れ)
- Stack Overflow:Windows Task Scheduler の実行結果に失敗を表示させる方法 (2015年、古い:需要の表れ)
このページは 2026年11月19日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。