【PowerShell】日次バッチをタスクスケジューラに登録する（Register-ScheduledTask 実戦）

みなさんこんにちは、ヒロポンです！

夜間バッチとか日次の定期処理、タスクスケジューラの GUI でポチポチ手作業登録してませんか？？

それ、別のサーバーに移すとき地獄を見るやつなんですよね。

「あれ、前任者がどんな設定で登録したんだっけ」で再現できない。あるあるでしょ。

PowerShell の Register-ScheduledTask を使えば、タスクスケジューラへの登録をまるごとスクリプト化できます。

今回は日次バッチを PowerShell でタスクスケジューラに登録する手順を、コピペで動く形で押さえていきます。サービスアカウントで登録した時にだいたい一回はハマる権限まわりも、まとめておきますね。

結論: Action・Trigger・Principal を組んで Register-ScheduledTask に渡すだけ

先に結論。タスク登録は、4つのパーツを組み立てて1発で登録します。

• New-ScheduledTaskAction … 何を実行するか（バッチ本体のスクリプト）
• New-ScheduledTaskTrigger … いつ動かすか（日次・時刻）
• New-ScheduledTaskPrincipal … 誰の権限で動かすか（実行ユーザー・特権）
• Register-ScheduledTask … 上の3つをまとめて登録

サービスアカウントで動かすなら、New-ScheduledTaskPrincipal の -LogonType と、アカウントの「バッチ ジョブとしてのログオン」権限がキモ。

ここを外すと「登録はできたのに実行だけ失敗する」という、一番わかりにくい詰まり方をします。

⚠️ 動作環境の前提: この記事のコマンド（ScheduledTasks モジュール）は Windows 専用です。Windows PowerShell 5.1、または Windows 上の PowerShell 7 で動きます。Linux / macOS の PowerShell や、コンテナ上の Linux pwsh には ScheduledTasks モジュールが入っていないので動きません。動作確認は Windows Server 上でやってください。

最短: コピペで動く登録スクリプト

まず全体像。4つのパーツがこう繋がって1タスクになります。

基本形: 毎朝2時に日次バッチを回す

一番シンプルな形。今ログオンしている自分（or 管理者）の権限で、毎朝2時にスクリプトを走らせます。

# 1. 何を実行するか（バッチ本体をフルパスで）
$action = New-ScheduledTaskAction `
    -Execute "powershell.exe" `
    -Argument "-NoProfile -ExecutionPolicy Bypass -File C:\batch\daily-batch.ps1"

# 2. いつ動かすか（毎日 2:00）
$trigger = New-ScheduledTaskTrigger -Daily -At 2am

# 3. 設定（PC起動時に時刻を過ぎてたら起動、実行時間の上限2時間）
$settings = New-ScheduledTaskSettingsSet `
    -StartWhenAvailable `
    -ExecutionTimeLimit (New-TimeSpan -Hours 2)

# 4. まとめて登録（同名タスクがあれば上書き）
Register-ScheduledTask `
    -TaskName "DailyBatch" `
    -Action $action `
    -Trigger $trigger `
    -Settings $settings `
    -Description "日次バッチ（PowerShellから登録）" `
    -Force

-Execute に powershell.exe、-Argument に実際のスクリプトを渡すのがコツ。

.ps1 を直接 -Execute に書くと、ダブルクリック相当の扱いになる。環境によっては「メモ帳で開く」みたいな事故になります。powershell.exe -File ... の形が確実。

-Force を付けておくと、同名タスクが既にあっても上書き登録してくれます。再実行できるスクリプトにしておくと、あとが楽。こんな感じで冪等に書いておくと事故りません。

サービスアカウントで登録する（対話ログオンなしで動かす）

夜間バッチは、誰もログオンしてなくても動いてほしい。そのためにサービスアカウント（専用のドメインアカウント）で登録します。

$action  = New-ScheduledTaskAction -Execute "powershell.exe" `
    -Argument "-NoProfile -ExecutionPolicy Bypass -File C:\batch\daily-batch.ps1"
$trigger = New-ScheduledTaskTrigger -Daily -At 2am

# 実行ユーザーをサービスアカウントに。最上位の特権で動かす
$principal = New-ScheduledTaskPrincipal `
    -UserId "CORP\svc_batch" `
    -LogonType Password `
    -RunLevel Highest

Register-ScheduledTask `
    -TaskName "DailyBatch" `
    -Action $action `
    -Trigger $trigger `
    -Principal $principal `
    -Description "日次バッチ（サービスアカウント実行）" `
    -Force

-LogonType Password は「保存したパスワードでログオンして動かす」モード。-RunLevel Highest で管理者相当の特権を付けます。

パスワードを直接渡したいなら、Principal を使わず Register-ScheduledTask に -User と -Password を直接渡す形でもいけます。

Register-ScheduledTask `
    -TaskName "DailyBatch" `
    -Action $action `
    -Trigger $trigger `
    -User "CORP\svc_batch" `
    -Password $plainPassword `
    -RunLevel Highest `
    -Force

ただ、このサービスアカウントで動かす形が一番ハマりが多い。次のハマりポイントで潰していきます。

組み込みアカウント（SYSTEM）で動かす場合

ネットワーク越しのリソースを触らない、ローカル完結のバッチなら、SYSTEM で動かすのが楽です。パスワード管理が要らない。

$principal = New-ScheduledTaskPrincipal `
    -UserId "SYSTEM" `
    -LogonType ServiceAccount `
    -RunLevel Highest

SYSTEM / LOCALSERVICE / NETWORKSERVICE みたいな組み込みアカウントは、Register-ScheduledTask に渡すパスワードも無視されます（そもそも要らない）。

ただし共有フォルダや別サーバーの DB を触るバッチだと、権限が足りないことがある。そこはサービスアカウントの出番です。