Task Scheduler はもうメールを送れません:タスクが失敗したときにアラートを受け取る
Windows のスケジュールタスクが失敗したらメールがほしいのに、Task Scheduler(タスク スケジューラ)自身の Send an e-mail(電子メールの送信)操作はグレーアウトしているか、エラーになります。この操作はもう廃止されており、よく使われるイベントログでの回避策には抜けがあります。タスクが失敗したときや実行されなかったときに、メールや Slack、Teams のメッセージを受け取るもっと簡単な方法があります。
Task Scheduler がもうメールを送れない理由
Microsoft は Windows 8 で Task Scheduler の 2 つの操作を非推奨にしました。Send an e-mail と Display a message(メッセージの表示)です。同社のページ「What's New in Task Scheduler」はこれらを非推奨の機能として挙げ、代わりに Send-MailMessage を使うスクリプトの実行を勧めています。ところが Send-MailMessage 自体も今では obsolete(廃止予定)とされています。Microsoft は、メールサーバーへの安全な接続を保証できないため使用すべきではないとしています。つまり、削除された操作の公式な代替手段もまた、消えつつあるのです。
フォーラムの回答で最もよく挙がる回避策は、ログ Microsoft-Windows-TaskScheduler/Operational の On an event(イベント時)でトリガーされ、メールを送る 2 つ目のタスクです。これは機能しますが、3 つの落とし穴があります。
- Operational ログは既定でオフです。Enable All Tasks History(すべてのタスク履歴を有効にする)でオンにします。
- イベント 201(action completed、操作の完了)は失敗時だけでなく成功時にも発生するため、トリガーには結果コードに対するカスタム XML フィルターが必要です。イベント 101 は起動に失敗したタスクを対象とします。これらのイベント ID についての Microsoft 自身の一覧は、Windows Server 2008 の時代のものです。
- 行われなかった実行は、イベントをまったく書きません。PC の電源が切れていた、あるいはタスクのアカウントがログオンできなかった場合、メールを送るきっかけは何もありません。「タスクが実行されなかったときのアラート」を求めるフォーラムのスレッドが回答のないまま残りがちなのは、そのためです。
さらに、そのマシンからのメールを受け付ける SMTP サーバーも必要ですが、多くの企業ネットワークではそれが許可されていません。
代わりにタスクから TaskBeacon に報告させる
イベントログを監視する代わりに、タスク自身に HTTPS で結果を報告させます。以下の PowerShell スクリプトはプログラムを実行して終了を待ち、その終了コードを TaskBeacon に送ります。失敗時には出力の最後の 20 行を加えます。その後、同じコードで終了するので、Task Scheduler の Last Run Result(前回の実行結果)も正しいままです。
# 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 tooアプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
タスクの操作で、Program(プログラム)に powershell.exe を、Arguments(引数)には先頭のコメントにあるとおりの内容を設定し、最後にあなたのプログラムとその引数を付けます。マシンに必要なものはほかにありません。SMTP サーバーも、メールプロファイルも、2 つ目のタスクも不要です。
得られるもの
- タスクが失敗したときのメール: 終了コードと出力の最後の数行付きです。同じアラートを Slack、Microsoft Teams、Discord、Google Chat、ntfy、Webhook にも、同僚のアドレスにも送れます(アラートを参照)。
- タスクが実行されなかったときのメール: ジョブのスケジュールをタスクのトリガーと同じように設定すると(毎日 06:00、平日、2 時間ごと …)、予定時刻に猶予時間を加えた時刻までに ping が届かなければ、ジョブは Missed(未実行)になります。これはイベントログのトリガーでは見えないケースです。
- いつもよりずっと長くかかっているときのメール(Late、遅延)と、OK に戻ったときのメール。
失敗しても 0 を返すプログラムの場合、ラッパーでは判別できません。代わりに、たとえば Python や R のコードで、スクリプトの中から報告してください。なぜそうなるのかは Task Scheduler に 0x0 と表示されるのにスクリプトが失敗しているで説明しています。
TaskBeacon を使わない場合
タスクの履歴を有効にし、Microsoft-Windows-TaskScheduler/Operational のイベント 201 でトリガーされるタスクを作成します。0 以外の ResultCode とタスク名に対する XML フィルターを付け、SMTP サーバー経由でメールを送る PowerShell スクリプトを実行させます(Send-MailMessage は obsolete なので、メールライブラリを使います)。起動に失敗したタスクのために、イベント 101 の 2 つ目のトリガーも追加します。これでその 1 台のマシン上の失敗はカバーできます。行われなかった実行については、合図を待ち受ける何かがマシンの外に必要です。それがハートビートチェックです。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
ドキュメント:PowerShell(Task Scheduler) · アラート · スケジュール
- Task Scheduler の Last Run Result は 0x0 なのに、スクリプトは失敗したLast Run Result 0x0 は、起動したプログラムが 0 を返したことしか意味しません。
- 定期ジョブがまったく実行されなかったことを知る行われなかった実行にはエラーがないため、アラートのきっかけがありません。
- PowerShell スクリプトのエラーと Task Scheduler の終了コード終了しないエラーでは終了コードが 0 のまま。-Command はコードを 0 か 1 にまとめてしまいます。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- Microsoft Learn:Task Scheduler の新機能(sendEmail と showMessage は Windows 8 で非推奨) (2018年5月31日、2025年3月11日更新、現在も最新のページ)
- Microsoft Learn: Send-MailMessage(非推奨と記載) (2024年6月18日、2026年6月16日更新)
- Microsoft Learn(以前のバージョン):Task Scheduler のイベント ID(例:101 タスクの開始に失敗) (2009年ごろ、古い:現在のページにはこれらの ID の一覧がない)
- Microsoft Q&A:Task Scheduler のジョブが失敗したときのメールアラートの作り方(メール送信オプションは非推奨) (2023年10月26日、古い:需要の表れ)
- Microsoft Q&A:Task Scheduler でスクリプトをスケジュールしてメール通知を設定する方法 (2024-04-27)
このページは 2026年11月19日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。