もくじ
📝 はじめに
スケジュールタスクを確認していると、
「このタスク、ちゃんと実行されているの?」
「最後に成功したのはいつ?」
と気になることはありませんか?
そんなときに使えるのが、
スケジュールタスクの実行結果や履歴を確認できる
Get-ScheduledTaskInfo です。
この記事では、タスクが正しく動作しているかを確認するための
基本的な使い方を解説します。
- タスクが成功しているか確認したい
- エラーで失敗していないか調べたい
- 自動実行トラブルの原因切り分けをしたい
✅ このコマンドでできること(要点)
- スケジュールタスクの最終実行結果を確認できる
- 最後に実行された日時を確認できる
- 次回の実行予定時刻を確認できる
- タスクが失敗しているか判断できる
✅ Get-ScheduledTaskInfo でできること
Get-ScheduledTaskInfo は、
指定したスケジュールタスクについて
実行結果や履歴情報を取得するコマンドです。
タスクの定義(設定内容)を見る
Get-ScheduledTask に対し、
こちらは「実際にどう動いたか」を確認するために使います。
自動処理の成否を判断するための重要な情報源です。
🧩 基本構文
Get-ScheduledTaskInfo -TaskName "タスク名"
タスク名を指定して実行結果を取得します。
同名タスクがある場合は -TaskPath の指定が必要です。
▶ 基本的な使い方(まずこれだけ)
🔹 タスクの実行結果を確認する
Get-ScheduledTaskInfo -TaskName "BackupTask"
LastRunTime(最終実行時刻)や
LastTaskResult(実行結果コード)が表示されます。
情報が表示されていれば、取得は正常です。
🔹 実行結果の見方
LastTaskResult が
0 の場合は正常終了を意味します。
それ以外の数値は、エラーや異常終了を示します。
🛠 よく使われる指定例
🔹 次回実行予定を確認する
Get-ScheduledTaskInfo -TaskName "BackupTask" | Select-Object NextRunTime
次にいつ実行される予定かを確認できます。
定期タスクの動作確認に便利です。
🔹 最終実行結果だけを確認する
Get-ScheduledTaskInfo -TaskName "BackupTask" | Select-Object LastTaskResult
成功・失敗の判定だけを素早く確認できます。
💼 実務でよく使う使用例(応用)
🔹 失敗しているタスクを洗い出す
Get-ScheduledTask | ForEach-Object {
Get-ScheduledTaskInfo -TaskName $_.TaskName -TaskPath $_.TaskPath
} | Where-Object LastTaskResult -ne 0
実行結果が正常でないタスクだけを抽出できます。
定期点検やトラブル対応でよく使われます。
🔹 タスク定義と結果をあわせて確認する
Get-ScheduledTask -TaskName "BackupTask" |
Get-ScheduledTaskInfo
- Get-ScheduledTask で設定確認
- Get-ScheduledTaskInfo で結果確認
- イベントビューアで詳細エラーを確認
🧩 よくある勘違い・つまずきポイント
- タスクが一度も実行されていないと結果が空になる
- LastTaskResult は Windows の終了コード
- 失敗理由の詳細は表示されない
- 管理者権限がないと取得できない場合がある
🔄 cmdとの違いについて
cmd の schtasks でも結果確認は可能ですが、
出力はテキスト形式で加工が大変です。
PowerShellの Get-ScheduledTaskInfo は、
結果をオブジェクトとして扱えるため、
条件抽出や自動チェックに向いています。
⚠ エラー・うまく動かないときの確認ポイント
- タスク名・パスが正しく指定されているか
- PowerShellを管理者として実行しているか
- タスクが一度は実行されているか
- Windowsのバージョンが対応しているか
🧠 注意点
Get-ScheduledTaskInfo では、
実行結果の「概要」までしか確認できません。
詳細なエラー原因は、
イベントビューアと併せて確認しましょう。
📌 まとめ
- Get-ScheduledTaskInfo はタスク結果確認の専用コマンド
- LastTaskResult が成功・失敗の判断材料
- 自動処理トラブルの切り分けに必須
- Get-ScheduledTask とセットで使うのが基本
🔎 PowerShellコマンドを探す
やりたいことからコマンドを探せます。
- ファイルを削除したい
- 一覧を表示したい
- 文字列を検索したい
- 条件で絞り込みたい
- エラーや実行できない原因を調べたい
- タスクの実行結果を確認したい
- 自動処理が動いているか確認したい
