[登録されているタグ]

[記事公開日]2025/12/21

PowerShellでタスクの実行結果を確認する|Get-ScheduledTaskInfoの使い方

📝 はじめに

スケジュールタスクを確認していると、
「このタスク、ちゃんと実行されているの?」
「最後に成功したのはいつ?」
と気になることはありませんか?

そんなときに使えるのが、
スケジュールタスクの実行結果や履歴を確認できる
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コマンドを探す

やりたいことからコマンドを探せます。

  • ファイルを削除したい
  • 一覧を表示したい
  • 文字列を検索したい
  • 条件で絞り込みたい
  • エラーや実行できない原因を調べたい
  • タスクの実行結果を確認したい
  • 自動処理が動いているか確認したい
Generic filters

サイト内検索(入力すると候補が出ます)

Generic filters


Generic filters

Generic filters

すべてを開く | すべてを閉じる
ページ上部へ戻る