VBScriptを掌握せよ：StdErrとStdOutの完全分離によるプロフェッショナル・パイプライン設計
多くのエンジニアが「VBScriptはレガシーだ」と切り捨て、`WScript.Echo`で全てを混ぜこぜに出力し、後からログの海で溺れている。しかし、Windowsの根幹を支えるWSH（Windows Script Host）の本質を知る者にとって、CScriptは強力なパイプライン・プロセッサーに他ならない。
今日は、稚拙なスクリプトを「堅牢なシステムコンポーネント」へと昇華させるための、標準ストリームの完全制御術を伝授する。
—
1. なぜ StdOut と StdErr を分離すべきなのか
`WScript.Echo`は、CScript実行時には標準出力(Stdout)へ流れるが、これはあくまで簡易的なインターフェースに過ぎない。バッチ処理を自動化し、後続のプロセスや監視ツールと連携させる際、「処理結果」と「異常系ログ」が同一ストリームに混在していることはアーキテクチャ上の最大の罪である。
- StdOut (1): データペイロード。後続のコマンド（findstr, jq, パイプ処理）へ渡すべき「成果物」。
- StdErr (2): システムの叫び。監視インフラへ飛ばすべき「異常・警告」。
これらをOSレベルで分離してリダイレクトさせることで、初めて自動化システムとしての品格が備わる。
—
2. 実装：StdErr を極めるためのストリーム制御
以下のコードは、単なるログ出力ではない。ストリームを明示的に取得し、メモリを適切に管理するプロフェッショナルの実装だ。
‘ CScript実行を前提とした、堅牢な標準ストリーム操作のテンプレート
Option Explicit
‘ メモリ最適化：オブジェクト参照を明示的に管理するためのスコープ
Call Main()
Sub Main()
Dim objStdout, objStderr
‘ WScript.StdOut/StdErr をオブジェクトとして取得
‘ これにより、バッファリングやフラッシュの制御が可能になる
Set objStdout = WScript.StdOut
Set objStderr = WScript.StdErr
On Error Resume Next
‘ — 処理ロジック —
objStdout.WriteLine “INFO: プロセス開始時刻 – ” & Now
‘ 疑似エラー発生箇所
If Not SimulateTask(objStderr) Then
objStderr.WriteLine “ERROR: タスク実行中に致命的な例外が発生しました。”
End If
objStdout.WriteLine “INFO: プロセス終了時刻 – ” & Now
‘ — クリーンアップ —
‘ VBScriptは参照カウンタ方式のため、明示的なNothing代入が重要
Set objStdout = Nothing
Set objStderr = Nothing
If Err.Number <> 0 Then
WScript.StdErr.WriteLine “CRITICAL: 予期せぬスクリプト終了: ” & Err.Description
WScript.Quit(1)
End If
End Sub
Function SimulateTask(ByRef errStream)
‘ 外部API連携やファイルI/Oを模倣
‘ エラーが発生した場合はStdErrに書き込み、Falseを返す
SimulateTask = False
End Function
—
3. OSレベルでのパイプライン制御（極限の活用法）
このスクリプトを呼び出すバッチファイル（.bat）側で、ストリームを分離する。これが真の自動化エンジニアの作法だ。
@echo off
:: 正常ログは log\output.log へ、エラーログは log\error.log へ分離する
:: 1> : 標準出力
:: 2> : 標準エラー出力
cscript //nologo my_script.vbs 1> “C:\logs\output.log” 2> “C:\logs\error.log”
:: 終了コードをチェックし、エラーがあればアラートを投げる
if %errorlevel% neq 0 (
echo [ALERT] システムエラーが発生しました。エラーログを確認してください。
)
—
4. チーフアーキテクトからの助言：プロのこだわり
オブジェクトのライフサイクル管理
VBScriptのエンジンは、スクリプト終了時に自動でリソースを解放するが、大規模なシステム連携や長時間稼働するWSHタスクでは、メモリリークを避けるために `Set obj = Nothing` を徹底せよ。これは単なるマナーではなく、OSリソースのデッドロックを防ぐための防衛策である。
Windows APIとの連携
もしVBScriptの標準機能では不足する場合、`WScript.Shell`の`Run`メソッドではなく、`Exec`メソッドを使用すること。`Exec`オブジェクトは`StdOut`と`StdErr`プロパティを持ち、外部コマンドの実行結果をリアルタイムで取得できる。これができるかどうかが、スクリプトの「おもちゃ」と「ツール」の分かれ目だ。
ログの排他制御
複数のプロセスが同一のログファイルに書き込む可能性がある場合は、VBScript単体では力不足だ。その際は、`Scripting.FileSystemObject`でファイルを掴み続けるのではなく、一度書き込んだら即座にストリームを閉じる「短時間オープン」を徹底するか、ログ集約用のミドルウェアを介する設計に切り替えろ。
—
結びとして：
VBScriptは古い。しかし、Windows環境においてこれほど軽量かつ強力にシステムを制御できる言語は他にない。StdErrを使いこなせ。パイプラインを支配せよ。それだけで、君の保守工数は劇的に減少し、システムは驚くほど静かに、かつ確実に動き出すはずだ。
