IIS6 に ASP.NET MVC 配置のためにワイルドカードマッピング追加するには JScript だけではできなかった

2010/10/28追記

その後、IIS6 に ASP.NET MVC 配置のためにワイルドカードマッピング追加するには JScript だけでできることが判明。
詳しくはこちらに投稿。

開発した ASP.NET Web アプリケーションを IIS6 に配置する話。
最近の IIS7.x だとまた事情が違うのだが、まだまだ IIS6 も根強く居残っているので。

さて、IIS6 上に ASP.NET Web アプリを配置するにあたっては、仮想フォルダのマッピングや、アプリケーションの作成などなど、IIS に対する構成作業が発生する。
インターネットインフォメーションサービスマネージャを使って毎度手作業で構成してもいいが、度々同じ構成作業が発生するようなら、スクリプトにまとめておくのが吉。
他のメンバーが作業するときにも役立つ。


ということで、IIS6 に対する構成作業の自動化なのだが、自分は WSH ( Windows Script Host ) ベースで、.wsf ( Windows Script File ) や .hta ( HTML Application ) の形で 、ADSI を JScript から呼び出す実装でスクリプト化している。

昨今は PowerShell などもあるし、古くは VBScript が IT 管理業務でよく使われているようなのだが、自分の場合、Web アプリケーション開発で JavaScript にはなじみが深いため、構文などで迷うことの無い JScript を選んで使っている。

さてさて、こうして作成・再利用してきた .wsf/.hta なのだが、最近はクラシカルな ASP.NET Web Form アプリではなく、ASP.NET MVC アプリの開発・配置も着々と増えてきた。

ここで、IIS6 上で ASP.NET MVC アプリを稼働させる場合、拡張子とISAPIハンドラとの関連づけが問題になる。

ひとつの解は、ASP.NET MVC のルーティング規則にて、何かしら拡張子 ― よくあるのは .mvc ― を付けることに決め、この拡張子と ASP.NET ISAPI 拡張とを関連づけする方法。

もうひとつは、IIS6 の「ワイルドカードアプリケーションマッピング」に、ASP.NET ISAPI 拡張を結びつけることだ。
「ワイルドカードアプリケーションマッピング」に登録された ISAPI 拡張は、要求の拡張子に関係なく呼び出されるようになる。
ASP.NET MVC における /SomeController/SomeAction といった URL をハンドルするにはうってつけだ。

ということで、ASP.NET MVC アプリ配置用のスクリプトにおいて、ワイルドカードアプリケーションマッピングも同時に設定することにした。

さて、IIS6 の拡張子とISAPI 拡張との関連づけは、JScript では次のように ScriptMaps プロパティで参照できる。

var vdir = GetObject("IIS://localhost/W3SVC/1/Root/SomeAppDir");
var scriptMaps = vdir.ScriptMasp;

この ScriptMaps プロパティが返すオブジェクトの型は何か?
どうやら VBArray のようだ。
.hta の場合、次にようにすると、すでにこの仮想フォルダにマッピング済みの、ひとつめのマッピング情報が表示される。

ａｌｅｒｔ(scriptMaps.getItem(0));

ワイルドカードアプリケーションマッピングを追加するには、拡張子を指定するところで、"*" を指定したマッピングを追加するだけでよい。

インターネットインフォメーションサービスマネージャのプロパティ画面だと、ワイルドカードアプリケーションマッピングの設定は別枠になっているので、ADSI 上もなにか特別なプロパティやメソッドでアクセスするのかと思ったが、そんなことはなく、他の拡張子関連づけと同じく ScriptMaps プロパティで参照・設定するのであった。

（ちなみに、Windows XP 上の IIS 5.x でも、インターネットインフォメーションサービスマネージャ画面にはワイルドカードアプリケーションマッピングの設定枠はないが、拡張子に "*" を指定した関連づけを追加してやることで、ワイルドカードアプリケーションマッピングができあがり、ASP.NET MVC アプリをホストできる）

では、scriptMaps にワイルドカードアプリケーションマッピングの要素をひとつ追加...と思ったのだが、なんと、これができない。

JScript 上、VBArray は読み取り専用
なのだそうだ。

は?

ということは、
JScript だけでは、どうがんばってみたところで、ワイルドカードアプリケーションマッピング（というか、任意のマッピング）は追加できない
ということである。

IT 管理系のスクリプトに VBScript がよく使われているっぽい（少なくともネット検索の結果では VBScript の事例を多く見かける）理由は、もしかしてこういうところにあるのか、などと今頃思ったり。


とにかく。

既存の JScript ベースのスクリプトを全面的に VBScript に書き換えるのもアホらしいので、マッピングの追加部分だけを VBScript で書くことにした。
幸い、.wsf や .hta であれば、ミクスドランゲージは可能である。

.hta であれば、script タグの lang 属性で仕分けるだけである。
ということで、こんな感じ。

<script lang="VBScript">
　Function AddMap(maps, newEntry)
　　ReDim Preserve maps(UBound(maps) + 1)
　　maps(UBound(maps)) = newEntry
　　AddMap = maps
　End Function
</script>

<script lang="JScript">
　var vdir = GetObject("IIS://localhost/W3SVC/1/Root/SomeAppDir");
　var scriptMaps = vdir.ScriptMasp;
　scriptMaps = AddMap(scriptMaps,"*,c:\windows\microsoft.net\framework\v2.0.50727\aspnet_isapi.dll,3");
　vdir.ScriptMaps = scriptMaps;
　vdir.SetInfo(); // 変更内容を保存
</script>

ちなみに上記は .NET4 ではなく .NET3.5ベースの ASP.NET MVC を配置する場合の例。

同じホスト ( .wsf や .hta ) の中であれば、VBScript で定義した関数やプロシージャを JScript から呼び出すことは普通に可能である（VBScript から JScript で定義した関数を呼び出すのも然り）。
COM 万歳、である。

VBScript は不慣れなのだが、ReDim ステートメントで Preserve オプションを指定しながら新たな要素数を指定することで、配列中の既存の要素はそのままに配列の要素数を増減できるとのこと。
また、UBound 関数で、配列の要素数を取得できるらしい（正確には、VBScript では配列の添え字の下限を0以外に変えられるので UBound は厳密には "上限" ということなのだが）。

こうして、VBScript をちょっと混ぜつつ、大体を JScript の記述としたまま、ワイルドカードアプリケーションマッピングの追加をスクリプトでできるようになった。