# Windows の定期タスクから「黒いコマンドウィンドウ」を消す 毎時・毎朝走るスケジュールタスクが、発火のたびに一瞬〜数十秒コンソール窓を出して作業を邪魔する問題を、**管理者権限なし・ログを失わず・終了コードも保ったまま**解決する手順。 ## 前提と原因 Windows のスケジュールタスクは `LogonType=Interactive`（＝「ユーザーがログオンしているときのみ実行」）だと、`node.exe` / `powershell.exe` / `*.cmd` を起動するたびにコンソール窓を必ず表示する。タスクの「表示しない(Hidden)」設定は**タスク一覧での表示可否**であって窓を隠す設定ではないので、チェックしても効かない。 正攻法は Principal を **S4U**（「ユーザーがログオンしているかどうかにかかわらず実行」）へ変えることだが、これは実行に管理者権限（SeTcbPrivilege）が要る。標準ユーザー権限では次のように必ず失敗する。 ```powershell $p = New-ScheduledTaskPrincipal -UserId $env:USERNAME -LogonType S4U -RunLevel Limited Set-ScheduledTask -TaskName '' -Principal $p # => Set-ScheduledTask: アクセスが拒否されました。 ``` `-WindowStyle Hidden` を PowerShell に渡す方法も、プロセス起動直後に窓が生成されてから隠れるため**一瞬フラッシュする**。 ## 解決策: コンソールホストを持たない wscript.exe から起動する `wscript.exe` は GUI サブシステムのアプリなのでコンソールを一切作らない。そこから中継用の VBScript で本体を起動すれば、窓はゼロになる。 ### 1. 中継スクリプトを置く（`/tools/run-hidden.vbs`） ```vbscript ' run-hidden.vbs -- run a command with NO console window at all. ' Usage (as a scheduled task action): ' Execute : C:\Windows\System32\wscript.exe ' Arguments : //nologo "<...>\tools\run-hidden.vbs" "" "" "" ... ' ASCII only on purpose: JP-locale script hosts mis-decode non-BOM UTF-8. Option Explicit Dim args, i, inner, exePath, baseName, logDir, logPath, shell, fso, rc, full Set args = WScript.Arguments If args.Count < 1 Then WScript.Quit 2 End If Set fso = CreateObject("Scripting.FileSystemObject") Set shell = CreateObject("WScript.Shell") exePath = args(0) baseName = fso.GetBaseName(exePath) If args.Count >= 2 Then ' Prefer the script name over the interpreter name for the log file. baseName = fso.GetBaseName(args(1)) End If logDir = shell.ExpandEnvironmentStrings("%USERPROFILE%") & "\.claude\logs" If Not fso.FolderExists(logDir) Then On Error Resume Next fso.CreateFolder logDir On Error Goto 0 End If logPath = logDir & "\" & baseName & ".log" ' Rotate at ~1 MB so the log cannot grow without bound. On Error Resume Next If fso.FileExists(logPath) Then If fso.GetFile(logPath).Size > 1048576 Then If fso.FileExists(logPath & ".1") Then fso.DeleteFile logPath & ".1", True fso.MoveFile logPath, logPath & ".1" End If End If On Error Goto 0 inner = "" For i = 0 To args.Count - 1 inner = inner & """" & args(i) & """" If i < args.Count - 1 Then inner = inner & " " Next ' cmd /s /c "<...>" always strips exactly the outer quotes, which keeps the ' quoting of the inner command intact regardless of spaces in paths. full = "cmd.exe /d /s /c " & """" & inner & " >> """ & logPath & """ 2>&1" & """" ' 0 = hidden window, True = wait so the exit code can be propagated. rc = shell.Run(full, 0, True) WScript.Quit rc ``` 設計上のポイント（省くと後で必ず困る）: - **stdout/stderr を必ずログへ落とす**。窓を消すと同時に出力も消えるため、リダイレクトを中継側に組み込まないと障害が無言化する。1MB ローテートまで入れておく。 - **終了コードを透過する**（`shell.Run(..., True)` で待って `WScript.Quit rc`）。これがないとタスクの `LastTaskResult` が常に 0 になり、失敗を検知できなくなる。 - **`cmd /d /s /c "…"`** で包む。`/s` を付けると「最初と最後の引用符だけを剥がす」挙動が確定するので、パスに空白や日本語が入っても内側の引用が壊れない。 - **VBS 本文は ASCII のみ**。日本語ロケールの Windows Script Host は BOM なし UTF-8 を誤デコードする。 ### 2. タスクのアクションを差し替える（管理者権限不要） ```powershell $repo = '' $vbs = Join-Path $repo 'tools\run-hidden.vbs' $node = (Get-Command node).Source $script = Join-Path $repo 'tools\.mjs' $arg = '//nologo "{0}" "{1}" "{2}" --limit 50' -f $vbs, $node, $script $a = New-ScheduledTaskAction -Execute "$env:SystemRoot\System32\wscript.exe" -Argument $arg -WorkingDirectory $repo Set-ScheduledTask -TaskName '' -Action $a ``` `Set-ScheduledTask -Action` は**自分が作ったタスクなら標準ユーザー権限で通る**（`-Principal` の変更だけが管理者権限を要求する）。 ### 3. 登録スクリプト側も同時に直す タスクを作る `register-*.ps1` を直さないと、**次に再登録した瞬間に窓が復活する**。`New-ScheduledTaskAction` の `-Execute` を `wscript.exe` に、`-Argument` を `//nologo "" "" ""` に変えておく。 ## 検証（沈黙を合格と誤読しないために） 1. **無害なプローブで経路を確かめる**（本番スクリプトは副作用があるので使わない）: ```powershell Set-Content .\probe.mjs 'console.log("out ok " + process.cwd()); console.error("err ok"); process.exit(7);' -Encoding ASCII $p = Start-Process 'C:\Windows\System32\wscript.exe' -ArgumentList '//nologo','"<...>\run-hidden.vbs"','"C:\Program Files\nodejs\node.exe"','".\probe.mjs"' -Wait -PassThru $p.ExitCode # => 7 なら終了コード透過OK Get-Content "$env:USERPROFILE\.claude\logs\probe.log" # => out/err 両方入っていればOK ``` 2. **パスに空白・日本語が入るケースを1回通す**（引用崩れはここで出る）。 3. タスクを `Start-ScheduledTask` で実走し、`Get-ScheduledTaskInfo` の `LastTaskResult` とログ内容の両方を見る。**窓が出なかったことだけを確認して終わらない**。 ## 適用してよいジョブ / だめなジョブ - **適用してよい**: 純 CLI の定期ジョブ（node / python / PowerShell スクリプト、HTTP を叩くだけの取込・集計・通知）。 - **適用しない**: ブラウザや GUI を**実際に画面へ出す必要がある**ジョブ。ただし「スクリプトが Chrome を起動する」だけなら中継してよい（隠れるのは中継の窓だけで、子の GUI は通常どおり表示される）。 - 名前で判断しない。`.cmd` の中身を読んで、GUI が必要かどうかを確かめてから決める。 ## よく踏む落とし穴 | 症状 | 原因 | 対処 | |---|---|---| | `Set-ScheduledTask` が Access Denied | 対象タスクが**管理者権限で作られている** | `Start-Process powershell -Verb RunAs`（UAC 1クリック）で実行。`-Wait` を付けずに起動し、あとからタスク状態をポーリングすれば自動化側が固まらない | | 窓は消えたが失敗に気付けない | 出力のリダイレクトを入れていない | 中継側で必ずログへ追記する（本手順に同梱） | | `LastTaskResult` が常に 0 | 中継が子を待たずに終了している | `shell.Run(..., True)` + `WScript.Quit rc` | | VBS が構文エラー | 日本語コメント + BOM なし UTF-8 | VBS は ASCII のみで書く | | 再登録したら窓が戻った | 登録スクリプトを直していない | `register-*.ps1` を同じコミットで直す | | タスクの削除・無効化が AI エージェント側でブロックされる | 破壊的操作のガード | 迂回せず、ダブルクリックで実行できる `.cmd`（ASCII のみ、失敗時に「管理者として実行」を案内する分岐入り）を用意して人に渡す。消す前に `Export-ScheduledTask` で XML バックアップ | ## 参考: 窓を出しているタスクの棚卸し ```powershell Get-ScheduledTask | Where-Object { $_.TaskPath -eq '\' -and $_.State -ne 'Disabled' -and $_.Principal.LogonType -eq 'Interactive' } | Select-Object TaskName, @{n='Exe';e={Split-Path $_.Actions.Execute -Leaf}}, @{n='Start';e={$_.Triggers[0].StartBoundary}} | Format-Table -AutoSize ``` `Exe` が `wscript.exe` 以外（`node.exe` / `powershell.exe` / `*.cmd` / `*.bat`）のものが窓を出す候補。時刻を見て「日中に発火するもの」だけを直せば、夜間ジョブはそのまま残せる。 ---