こんにちは！VBScriptの世界へようこそ。
業務の自動化を進めていくと、「バッチファイルやVBScriptに、外から設定ファイルや処理対象のファイルを渡したいな」という壁に必ずぶつかります。ダブルクリックして動かすだけのスクリプトから卒業し、「引数（ひきすう）」を自在に操れるようになると、あなたの自動化ツールは一気に「プロ仕様のアプリケーション」へと進化します。
今回は、WSH（Windows Script Host）が標準で提供する `WScript.Arguments` オブジェクトを深掘りし、「名前付き引数（Named）」と「位置引数（Unnamed）」を完璧に使い分ける、実戦的なコマンドラインパーサーの構築方法を伝授します。
ここをクリアすれば、VBScriptの入力インターフェース設計はもうバッチリですよ！さあ、一緒に本質を学んでいきましょう。
—
1. コマンドライン引数の基本概念：Named と Unnamed の違い
私たちがコマンドプロンプトやショートカットからVBScript（`cscript.exe` または `wscript.exe`）を実行する際、スクリプトの後ろにスペース区切りで渡す文字列を「引数」と呼びます。
WSHの `WScript.Arguments` は、これらを自動的に2つのコレクションに分類してくれます。
1. `WScript.Arguments.Unnamed`（位置引数）
- 順番が命の引数です。「入力ファイル名」「出力先ディレクトリ」など、書かれた順序に意味があるものに使います。
- 例：`script.vbs input.txt output.txt` （1番目が `input.txt`、2番目が `output.txt`）
2. `WScript.Arguments.Named`（名前付き引数）
- キーと値のペアで指定する引数です。順番は関係ありません。
- VBScriptでは `/key:value` または `-key:value` の形式で渡します。
- 例：`script.vbs /config:settings.ini /debug:true`
これらを適切にハンドリングすることで、柔軟で堅牢なスクリプトが作れるようになります。
—
2. 陥りやすい罠：VBScriptの引数処理における「お約束」とエラー
実務でVBScriptの引数を扱い始めると、多くのエンジニアが次のような「罠」にハマります。
- 罠1：引数が足りない状態で実行されてエラー落ちする
ユーザーが必須のファイル名を指定しずに実行した際、いきなりスクリプトが異常終了して黒い画面（CUI）が消えてしまう。
- 罠2：存在しない名前付き引数を参照してクラッシュする
`WScript.Arguments.Named(“config”)` を直接叩いたとき、そのキーが指定されていないと、VBScriptは容赦なく「プロシージャの呼び出しまたは引数が不正です」というエラーを吐いて停止します。
プロ仕様のスクリプトを目指すなら、「引数の存在チェック（バリデーション）」「デフォルト値のフォールバック」「親切なヘルプメッセージの表示」を必ず実装すべきです。
—
3. 【実践】プロ仕様のコマンドラインパーサー構築コード
それでは、現場でそのままコピペして使える、堅牢な引数解析モジュールを紹介します。
このスクリプトは、必須の位置引数（入力ファイル）を受け取りつつ、名前付き引数で「設定ファイル（`/config`）」や「デバッグモード（`/debug`）」を任意で指定できる優れものです。
メモ帳などに貼り付け、ファイル名を `parser_sample.vbs` として保存してください。
‘ ==============================================================================
‘ ファイル名: parser_sample.vbs
‘ 概要: 堅牢なコマンドライン引数解析（Named / Unnamed）のサンプル実装
‘ 実行方法の例:
‘ cscript parser_sample.vbs input.txt /config:C:\tmp\app.ini /debug
‘ ==============================================================================
Option Explicit
‘ メイン処理の実行
Main
Sub Main()
Dim objArgs, namedArgs, unnamedArgs
Dim configPath, debugMode, inputFilePath
Set objArgs = WScript.Arguments
Set namedArgs = objArgs.Named
Set unnamedArgs = objArgs.Unnamed
‘ 1. ヘルプ要求のチェック (/h または /help が指定されている場合)
If namedArgs.Exists(“h”) Or namedArgs.Exists(“help”) Then
Call ShowHelp()
Exit Sub
End If
‘ 2. 必須の位置引数（Unnamed）のバリデーション
‘ 今回は入力ファイルを必須の1番目として定義
If unnamedArgs.Count < 1 Then
WScript.Echo "[エラー] 必須の入力ファイルが指定されていません。" & vbCrLf
Call ShowHelp()
WScript.Quit 1
End If
inputFilePath = unnamedArgs(0) ' 1番目の位置引数を取得
' 3. 名前付き引数（Named）の取得とデフォルト値の設定
' /config が指定されていなければデフォルト値を設定
If namedArgs.Exists("config") Then
configPath = namedArgs("config")
Else
configPath = "default_settings.ini" ' デフォルト値
End If
' /debug が指定されているかチェック（フラグとしての利用）
If namedArgs.Exists("debug") Then
debugMode = True
Else
debugMode = False
End If
' 4. パース結果の確認（実際の業務処理に渡すデータ）
WScript.Echo "=== 引数解析成功 ==="
WScript.Echo "入力ファイル (Unnamed): " & inputFilePath
WScript.Echo "設定ファイル (Named) : " & configPath
WScript.Echo "デバッグモード : " & CStr(debugMode)
WScript.Echo "===================="
' --- ここに実際の業務ロジックを記述します ---
End Sub
' ------------------------------------------------------------------------------
' ヘルプメッセージを表示するサブルーチン
' ------------------------------------------------------------------------------
Sub ShowHelp()
Dim scriptName
scriptName = WScript.ScriptName
WScript.Echo "--------------------------------------------------------"
WScript.Echo " ツール名: 業務データ処理オートメーション"
WScript.Echo " 使い方: cscript " & scriptName & "
WScript.Echo “——————————————————–”
WScript.Echo ” 引数の説明:”
WScript.Echo ”
WScript.Echo ” /config:
WScript.Echo ” /debug : デバッグモードを有効化（任意・フラグ）”
WScript.Echo ” /help または /h : このヘルプを表示します”
WScript.Echo “——————————————————–”
End Sub
—
4. コードの深掘り解説：ここがプロの技
上記のコードで、VBScriptをワンランク上に引き上げる重要なポイントを解説します。
① `Option Explicit` の常時宣言
VBScriptの基本中の基本ですが、変数の宣言忘れを防ぐために必ずスクリプトの先頭に記述します。タイポによるバグを未然に防ぎ、保守性を劇的に高めます。
② `.Exists()` メソッドによる安全な存在確認
名前付き引数を扱う際、いきなり `namedArgs(“config”)` と書くと、その引数が与えられなかった場合にスクリプトがクラッシュします。
必ず `If namedArgs.Exists(“config”) Then` のように存在を確認してから値にアクセスするのが、プロの鉄則です。
③ コマンドプロンプト（`cscript.exe`）での実行推奨
VBScriptは `wscript.exe` で実行すると、出力結果がGUIのポップアップ（メッセージボックス）で表示されてしまい、コマンドラインツールとしては非常に使い勝手が悪くなります。
引数を解析するスクリプトを走らせるときは、コマンドプロンプトから `cscript स्क्रिप्ट名.vbs` で実行するクセをつけましょう。
—
まとめ
今回は、VBScriptにおけるコマンドライン引数解析の実践手法について解説しました。
- 位置引数（`Unnamed`）で「順序が重要なデータ（ファイルパス等）」を受け取る
- 名前付き引数（`Named`）で「オプション設定（`/config` や `/debug`）」を柔軟に受け取る
- `.Exists()` で安全性を担保し、エラー時にはヘルプを親切に表示する
このパターンを一度自分のなかにストックしておけば、今後どんな複雑なバッチ処理やツール作成を依頼されても、スマートに対応できるようになります。
「たかがVBScript、されどVBScript」。細部にまで気を配った美しいコードで、周囲をあっと言わせる自動化エンジニアを目指していきましょう！
