権限不足で死ぬスクリプトは、ツールではない。――VBScriptにおける「自己昇格」ブートストラップの実装論
業務自動化の現場において、VBScriptは今なお現役の強力な武器だ。しかし、多くの開発者が陥る致命的な罠がある。それは、「実行環境の権限をコントロールできていない」という事実だ。
レジストリの `HKEY_LOCAL_MACHINE` への書き込み、システムディレクトリへのファイル操作、あるいは特定のサービス制御。これら「管理者権限」を要求するタスクを扱う際、権限不足による `Permission Denied (800A0046)` でスクリプトが異常終了する設計は、プロフェッショナルとは言えない。エラーを `On Error Resume Next` で握りつぶすなど、言語の仕様を悪用した逃避に過ぎない。
真に堅牢な自動化ツールとは、「自らの権限を検知し、必要であればユーザーに昇格を要求し、適切なコンテキストで処理を完遂する」設計思想を持っていなければならない。
本稿では、VBScriptにおける「自己昇格(Self-Elevation)」機能付きブートストラップ・テンプレートを提示する。単なるコピペ用コードではない。なぜこの設計が必要なのか、その裏側にあるアーキテクチャを解説しよう。
1. 設計思想:リアクティブからプロアクティブへ
初心者は「エラーが出てから対処」する。これをリアクティブ(反応的)な設計と呼ぶ。
プロフェッショナルは「エラーが起きる前に状態を判定」する。これをプロアクティブ(先制的な)設計と呼ぶ。
管理者権限が必要な処理を行う場合、以下の3ステップを実装するのが、最も洗練されたワークフローだ。
1. 権限の検知(Sentinel): 現在のプロセスが管理者特権(Administrator Token)を持っているかを判定する。
2. 昇格のトリガー(Bootstrap): 権限が不足している場合、`Shell.Application` オブジェクトの `runas` 動詞を利用して、自分自身を管理者として再起動する。
3. コンテキストの維持(Context Preservation): 再起動後も、元のスクリプトが持っていた引数や、作業ディレクトリの整合性を保つ。
2. 陥りやすい「作業ディレクトリ」の罠
ここで、中級者が必ず踏む地雷について触れておく。
管理者権限で `wscript.exe` を起動すると、スクリプトの作業ディレクトリ(Current Directory)が、スクリプトの場所ではなく `C:\Windows\System32` に強制的に変更される。
もし君のスクリプトが、同じフォルダにある設定ファイルやログファイルを相対パスで参照していたらどうなるか? 確実にファイルが見つからず、エラーで爆死する。
「常に、実行ファイル(スクリプト)の絶対パスを基準に、作業ディレクトリを再定義せよ」
これが、堅牢なツールを書くための鉄則だ。
3. プロダクション・グレード:自己昇格テンプレート
以下に、実務でそのまま投入可能な、堅牢なブートストラップ構造を実装したコードを示す。
'==============================================================================
' Title: Self-Elevating Bootstrap Template for VBScript
' Author: Chief Architect
' Description: 管理者権限をチェックし、不足していればUACダイアログを表示して
' 自分自身を管理者として再実行する。
'==============================================================================
Option Explicit
' --- グローバル定数 ---
Const UAC_PROMPT_MSG = "管理者権限への昇格が必要です。UACダイアログを確認してください。"
' --- メインエントリポイント ---
Call Main()
Sub Main()
On Error GoTo ErrorHandler
' 1. 権限チェックと昇格プロセス
If Not IsAdmin() Then
Call Elevate()
' 昇格プロセスへ委譲した後、現在のプロセスは終了する
WScript.Quit
End If
' 2. 作業ディレクトリの固定 (重要: System32への遷移を防ぐ)
' 管理者実行時にカレントディレクトリが System32 に変わる問題への対策
Call SetWorkingDir(WScript.ScriptFullName)
'--------------------------------------------------------------------------
' ここから下に、本来実行したいロジックを記述する
'--------------------------------------------------------------------------
Call BusinessLogic()
'--------------------------------------------------------------------------
' ロジック終了
'--------------------------------------------------------------------------
WScript.Echo "処理が正常に完了しました。"
WScript.Quit
ErrorHandler:
WScript.Echo "【致命的エラー】" & vbCrLf & Err.Description & " (Error No: " & Err.Number & ")"
' ログ出力などの処理をここに追加すべき
WScript.Quit 1
End Sub
'------------------------------------------------------------------------------
' 関数: IsAdmin
' 目的: 現在のプロセスが管理者権限を持っているかを判定する
' 仕組み: "net session" コマンドは管理者権限がないと失敗することを利用
'------------------------------------------------------------------------------
Function IsAdmin()
Dim objShell, intReturn
Set objShell = CreateObject("WScript.Shell")
On Error Resume Next
' net session コマンドを隠しウィンドウで実行。エラーコードが0なら管理者。
intReturn = objShell.Run("net session", 0, True)
If Err.Number <> 0 Then
intReturn = 1 ' エラーが発生=権限不足とみなす
End If
On Error GoTo 0
IsAdmin = (intReturn = 0)
End Function
'------------------------------------------------------------------------------
' 関数: Elevate
' 目的: ShellExecuteの"runas"動詞を用いて、自分自身を管理者として再起動する
'------------------------------------------------------------------------------
Function Elevate()
Dim objShellApp, strArgs, strCmd
Set objShellApp = CreateObject("Shell.Application")
' 実行中のスクリプトパスを取得
strCmd = WScript.ScriptFullName
' コマンドライン引数を引き継ぐための処理
' WScript.Arguments を結合して、再起動時にも引数を渡せるようにする
strArgs = ""
If WScript.Arguments.Count > 0 Then
Dim i
For i = 0 To WScript.Arguments.Count - 1
strArgs = strArgs & " """ & WScript.Arguments(i) & """"
Next
End If
' ShellExecute を用いて "runas" (管理者として実行) を呼び出す
' wscript.exe を介して実行することで、引数とパスを確実に渡す
On Error Resume Next
objShellApp.ShellExecute "wscript.exe", """" & strCmd & """" & strArgs, "", "runas", 1
If Err.Number <> 0 Then
MsgBox "昇格に失敗しました。ユーザーがキャンセルしたか、システムの設定により拒否されました。", vbCritical, "エラー"
Else
MsgBox UAC_PROMPT_MSG, vbInformation, "昇格プロセス"
End If
On Error GoTo 0
End Function
'------------------------------------------------------------------------------
' 関数: SetWorkingDir
' 目的: スクリプトが存在するディレクトリを作業ディレクトリとして設定する
'------------------------------------------------------------------------------
Sub SetWorkingDir(strFilePath)
Dim objFSO, strPath
Set objFSO = CreateObject("Scripting.FileSystemObject")
strPath = objFSO.GetParentFolderName(strFilePath)
' カレントディレクトリの変更
' ※VBScript自体には直接的な ChDir の制約がある場合があるため、
' 実務では常に絶対パスを使用してファイル操作を行う設計を推奨する。
' ここでは、念のためカレントディレクトリを移動させておく。
Set objShell = CreateObject("WScript.Shell")
objShell.CurrentDirectory = strPath
End Sub
'------------------------------------------------------------------------------
' サブルーチン: BusinessLogic
' 目的: 実際の業務ロジック(レジストリ操作など)を記述する場所
'------------------------------------------------------------------------------
Sub BusinessLogic()
' 例: レジストリへの書き込み(管理者権限が必要な領域)
Dim objReg
Set objReg = CreateObject("WScript.Shell")
' HKLMへの書き込みを試行
objReg.RegWrite "HKEY_LOCAL_MACHINE\SOFTWARE\MyCustomTool\Version", "1.0.0", "REG_SZ"
' ファイル操作の例(絶対パスを使用すること)
' Dim objFSO: Set objFSO = CreateObject("Scripting.FileSystemObject")
' objFSO.CreateTextFile(objFSO.GetParentFolderName(WScript.ScriptFullName) & "\log.txt")
End Sub
4. アーキテクトからの最終アドバイス
このテンプレートを運用するにあたり、以下の3点を忘れないでほしい。
1. 引数の継承(Argument Passing):
`Elevate` 関数内では、`WScript.Arguments` をループで回し、再起動後のプロセスにも元の引数を渡すように設計している。これを怠ると、コマンドライン引数を利用した運用ツールが機能しなくなる。
2. エラーハンドリングの階層化:
`Main` 関数に `On Error GoTo ErrorHandler` を配置し、致命的なエラーが発生した際に、ユーザーに「何が起きたか」を明確に伝える設計にしている。ユーザーに「動かない」とだけ言わせるようなツールは、メンテナンスコストを増大させる。
3. DBやネットワーク連携の注意点:
管理者権限で実行すると、ネットワークドライブの割り当て(Mapped Drives)が見えなくなるケースがある。これは、管理者権限のトークンと標準ユーザーのトークンが別物であるためだ。DB接続やファイル共有へのアクセスを行う場合は、ドライブレター(`Z:\`)ではなく、UNCパス(`\\Server\Share\`)を使用すること。これが、プロフェッショナルな回避策だ。
自動化とは、単に作業を減らすことではない。「いかなる環境においても、予測可能な結果を、予測可能な方法で提供すること」である。このテンプレートを礎に、真に堅牢なシステムを構築してほしい。
