IIS モジュールの概要

IIS チーム、Mike Volodarsky

互換性

はじめに

IIS 7 以降の Web サーバー機能セットは、30 を超える独立したモジュールにコンポーネント化されています。

モジュールは、Win32 DLL (ネイティブ モジュール) またはアセンブリに含まれる .NET 2.0 型 (マネージド モジュール) のいずれかです。 一連の構成要素と同様に、モジュールはアプリケーションに必要な機能を提供するためにサーバーに追加されます。 同様に、すべての IIS モジュールは削除したり、IIS C++ API または使い慣れた ASP.NET 2.0 API を使用して開発されたカスタム モジュールに置き換えたりすることもできます。

この記事では、一般的な IIS モジュール管理タスクについて説明し、各モジュールの構成設定や、モジュールの削除が Web サーバーに与える潜在的な影響について詳しく説明します。 管理の例については、グラフィカル IIS マネージャーと AppCmd コマンド ライン ツールの両方を使用して提供されます。

前提条件

このドキュメントの手順に従うには、IIS の完全インストールを行うことをお勧めします。

Windows Vista、Windows 7、Windows 8、Windows 10、または Windows 11 で IIS の完全インストールを実行するには

1. [スタート] ボタンをクリックし、コントロール パネル をクリックします。
2. [コントロール パネル] で、[プログラム] を選択します。
3. [プログラムと機能] で [Windows の機能を有効化または無効化] をクリックします。
4. [Windows の機能] ダイアログで、[インターネット インフォメーション サービス] を展開し、すべての機能を選択します。
   一部のカテゴリを展開して、そのカテゴリのすべての機能を選択する必要がある場合があります。
5. OK をクリックします。

Windows Server 2008/R2、Windows Server 2012/R2、または Windows Server 2016 で IIS の完全インストールを実行するには

1. [サーバー マネージャー] > [ロール] を開き、[Web サーバー (IIS)] を選択します。
2. [Web サーバー] の下のすべての機能をオンにします。

モジュールの使用を開始する

サーバーにモジュールを追加するには、次の 2 つの手順を実行する必要があります。

1. サーバーにモジュールをインストールする (ネイティブ モジュールのみ)。
2. アプリケーションでモジュールを有効にする。

最初の手順では、モジュールをサーバーにグローバルに登録し、各サーバー ワーカー プロセス内でモジュールを使用できるようにします。 これは、ネイティブ コードの信頼できる性質のためにネイティブ モジュールにのみ必要であり、管理者のみが使用できます。

2 番目の手順では、モジュールを特定のアプリケーション内で実行できるようにし、アプリケーション管理者がアプリケーションに対して有効になっているサーバー機能を効果的に制御できるようにします。 この手順により、インストールされているネイティブ モジュールとマネージド モジュールの両方をアプリケーションごとに有効にすることができます。

ネイティブ モジュールをインストールするには

ネイティブ モジュールをインストールするには、次のいずれかのオプションを使用してサーバーに登録する必要があります。

• IIS 構成ストアを手動で編集する。 IIS 7.5 以降では、IIS マネージャーで構成エディターを使用できます。
• IIS マネージャーを使用する
• AppCmd.exe コマンド ライン ツールを使用する

これら 3 つのオプションすべてで、モジュール エントリが <globalModules> IIS 構成セクションに追加されます。これは、サーバー レベルでのみ設定できます。 このセクションの内容を調べるには、%windir%\system32\inetsrv\config\applicationhost.config にあるルート構成ファイル開き、文字列 "<globalModules>" を検索します。

IIS の完全インストール後、このセクションには、IIS に付属している各ネイティブ モジュールのエントリが含まれ、モジュール DLL の名前とパスが指定されています。

<globalModules>
    <add name="DefaultDocumentModule" image="%windir%\system32\inetsrv\defdoc.dll" />
    <add name="DirectoryListingModule" image="%windir%\system32\inetsrv\dirlist.dll" />
    <add name="StaticFileModule" image="%windir%\system32\inetsrv\static.dll" />
    ...

</globalModules>

これらのモジュールはすべて、このドキュメントの後で詳しく説明します。

ネイティブ モジュールをアンインストールするには

特定のネイティブ モジュールがサーバーで使用されなくなった場合、または別のモジュールで置き換える場合は、ネイティブ モジュールをアンインストールできます。 次のいずれかのオプションを使用して、対応するモジュール エントリを <globalModules> 構成リストから削除し、<modules> 構成リスト内の関連エントリを削除します。

• IIS 構成ストアを手動で編集する。 IIS 7.5 以降では、構成エディターを使用できます。
• IIS マネージャーを使用する
• AppCmd.exe コマンド ライン ツールを使用する

アプリケーションのモジュールの有効化

モジュールは、特定のアプリケーションにサービスを提供する前に有効にする必要があります。 ネイティブ モジュールを有効にするには、最初にサーバーにインストールする必要があります (前のセクション「ネイティブ モジュールをインストールするには」を参照してください)。

マネージド モジュールはインストールを必要とせず、アプリケーションごとに直接有効にすることができます。 これにより、アプリケーションは、アプリケーションの web.config ファイルにマネージド モジュールを登録し、/BIN または /App_Code ディレクトリに実装を提供することによって、マネージド モジュールをアプリケーション内に直接含めることができます。

モジュールを有効にするには、次のいずれかの操作を行います。

• IIS 構成ストアを手動で編集します。サーバー上のすべてのアプリケーションに対してグローバルにモジュールを有効にするか、そのモジュールを有効にする各アプリケーション内にある特定の web.config ファイルでモジュールを有効にします。 IIS 7.5 以降では、構成エディターを使用できます。
• IIS マネージャーを使用する
• AppCmd.exe コマンド ライン ツールを使用する

これらの 3 つのオプションはすべて、<modules> IIS 構成セクションにモジュール エントリを追加します。これは、サーバー レベルとアプリケーション レベルの両方で設定できます。 このセクションの内容を調べるには、%windir%\system32\inetsrv\config\applicationhost.config にあるルート構成ファイル開き、文字列 "<modules>" を検索します。

ネイティブ モジュールとは異なり、マネージド モジュールでは、<globalModules> 構成セクションにエントリを追加する必要はありません。

IIS の完全インストール後、構成セクションには、IIS に付属している各モジュール (マネージドとネイティブの両方) のエントリが含まれます。 このエントリは、これらのモジュールがすべて、サーバー上のすべてのアプリケーションに対して既定で有効になっていることを示します。 このセクションの各エントリでは、サーバーに以前にインストールされたネイティブ モジュールの名前、またはマネージド モジュールの名前と .NET 型を指定します。

<modules>
<add name="DefaultDocumentModule" />
<add name="DirectoryListingModule" />
<add name="StaticFileModule"/>
 ...

</modules>

アプリケーションでのモジュールの無効化

モジュールがアプリケーションで使用されなくなった場合、または別のモジュールに置き換える場合は、モジュールを無効にします。 モジュールを無効にするには、このモジュールを実行しない特定のアプリケーションの <modules> 構成コレクションから対応するモジュール エントリを削除します。 モジュールがサーバー レベルで有効になっている場合は、モジュールを削除して、サーバー上のすべてのアプリケーションで既定で無効にします。 サーバー レベルでモジュールを削除するには、次のいずれかのオプションを使用します。

• アプリケーションの <system.webServer>/<modules> 構成セクションを 手動で編集する。
• IIS マネージャーを使用する。
• AppCmd.exe コマンド ライン ツールを使用する。

モジュールがアプリケーションから削除されると、そのアプリケーションではアクティブになりません。 ただし、モジュールがネイティブの場合、モジュールは引き続きサーバー ワーカー プロセスに読み込まれ、それを削除しなかった他のアプリケーションによって使用される可能性があります。

Preconditions

モジュール エントリには、前提条件と呼ばれる別の属性があります。 IIS コア エンジンは、前提条件を使用して、特定のモジュールを有効にするタイミングを決定します。 たとえば、パフォーマンス上の理由から、マネージド ハンドラーにも送信される要求に対してマネージド モジュールのみを実行する必要があると判断する場合があります。 次の例の前提条件 (precondition="managedHandler") では、.aspx または .asmx ファイルへの要求など、マネージド ハンドラーによっても処理される要求に対してのみフォーム認証モジュールが有効になります。

<add name="FormsAuthentication"type="System.Web.Security.FormsAuthenticationModule" preCondition="managedHandler" />

属性 precondition="managedHandler" を削除すると、フォーム認証は、.html、.jpg、.doc などのマネージド ハンドラーによって提供されないコンテンツに加えて、従来の ASP (.asp) または PHP (.php) 拡張機能にも適用されます。 すべてのコンテンツに対して ASP.NET モジュールを実行できるようにする例については、「IIS 統合パイプラインを利用する方法」を参照してください。

また、ショートカットを使用して、"managedHandler" の前提条件に関係なく、すべてのマネージド (ASP.NET) モジュールがアプリケーション内のすべての要求に対して実行されるようにすることもできます。 "managedHandler" の前提条件を削除するように各モジュール エントリを構成せずにすべてのマネージド モジュールをすべての要求に対して実行できるようにするには、<modules> セクションの runAllManagedModulesForAllRequests プロパティを使用します。

<modules runAllManagedModulesForAllRequests="true"/>

このプロパティを使用すると、"managedHandler" の前提条件は効果がなくなり、すべての要求に対してすべてのマネージド モジュールが実行されます。

IIS マネージャーを使用したモジュールのクエリ、追加、および削除

IIS マネージャーでは、モジュールのクエリ、追加、または削除を簡単に行う方法が用意されています。

1. IIS マネージャーを開くには、[スタート] をクリックし、[検索] ボックスに「inetmgr」と入力して、Enter キーを押します。
2. IIS サーバーのコンピューター名をクリックします。
3. [IIS] カテゴリの [モジュール] アイコンをクリックします。

図 1: IIS マネージャー

特定のアプリケーションで有効なモジュールを管理するには

1. 左側のツリー ビューを使用して、そのアプリケーションに接続します。
2. [モジュール] 機能ウィンドウに移動します。
3. [マネージド モジュールの追加] をクリックして、マネージド モジュールをアプリケーションに追加します。 [ネイティブ モジュールの追加] では、サーバー レベルで既に登録されているモジュールのみを追加できます。

アプリケーションからモジュールを削除するには

1. 一覧でモジュールをクリックします。 [削除] タスクが左側のウィンドウに表示されます。
2. 削除 をクリックします。

図 2: IIS マネージャーのモジュール一覧

コマンド ラインからのモジュールの管理

コマンド ラインからモジュールをすばやく管理したり、モジュール管理タスクのスクリプトを作成したりするには、AppCmd.exe コマンド ライン ツールを使用します。

AppCmd.exe を使用してモジュールをインストールするには

コマンド プロンプトで、次のコマンドを入力し、斜体の値をコンピューター上のモジュールの値に置き換えます。

Appcmd.exe install module /name:MODULE_NAME /image:PATH_TO_DLL

たとえば、次のコマンドは、既定のドキュメント モジュールをインストールします。

%windir%\system32\inetsrv\appcmd.exe install module /name:DefaultDocumentModule /image:%windir%\system32\inetsrv\defdoc.dll

モジュールが既に読み込まれているコンピューターでこのコマンドを実行すると、次のようなエラー メッセージが表示されます。

ERROR (メッセージ: 重複するコレクション要素 "DefaultDocumentModule" を追加できませんでした。)

AppCmd.exe を使用してモジュールをアンインストールするには

コマンド プロンプトで、次のコマンドを入力し、斜体の値をコンピューター上のモジュールの値に置き換えます。

Appcmd.exe uninstall module MODULE_NAME

たとえば、次のコマンドは、既定のドキュメント モジュールをアンインストールします。 このコマンドは、単に例として示されています。 テスト サーバーでのみ実行してください。

%windir%\system32\inetsrv\appcmd.exe uninstall module DefaultDocumentModule

アプリケーションに対してまたはグローバルに有効になっているモジュールを一覧表示するには

コマンド プロンプトで、次のコマンドを入力し、斜体の値をコンピューター上のモジュールの値に置き換えます。

Appcmd.exe list modules [/app.name:APPLICATION_NAME]

たとえば、次のコマンドは、既定の Web サイトに対して有効になっているモジュールを一覧表示します。

%windir%\system32\inetsrv\appcmd.exe list modules /app.name:"Default Web Site"

このコマンドは、グローバルにインストールされているモジュールを一覧表示します。

%windir%\system32\inetsrv\appcmd.exe list modules

特定のアプリケーションに対してまたはグローバルにモジュールを有効にするには

コマンド プロンプトで、次のコマンドを入力し、斜体の値をコンピューター上のモジュールの値に置き換えます。

Appcmd.exe add module /name:MODULE_NAME /type:MGD_TYPE

たとえば、次のコマンドは、フォーム認証モジュールを既定の Web サイトに追加します。

%windir%\system32\inetsrv\appcmd.exe add module /name:FormsAuthentication /type:System.Web.Security.FormsAuthenticationModule /app.name:"Default Web Site"

このコマンドは、フォーム認証モジュールをグローバルに追加します。

%windir%\system32\inetsrv\appcmd.exe add module /name:FormsAuthentication /type:System.Web.Security.FormsAuthenticationModule

特定のアプリケーションに対してまたはグローバルにモジュールを無効にするには

コマンド プロンプトで、次のコマンドを入力し、斜体の値をコンピューター上のモジュールの値に置き換えます。

Appcmd.exe delete module MODULE_NAME [/app.name:APPLICATION_NAME]

たとえば、次のコマンドは、フォーム認証モジュールを既定の Web サイトから削除します。

%windir%\system32\inetsrv\appcmd.exe delete module FormsAuthentication /app.name:"Default Web Site"

このコマンドは、フォーム認証モジュールをグローバルに削除します。

%windir%\system32\inetsrv\appcmd.exe delete module FormsAuthentication

各 App Cmd.exe コマンドの構文に関するヘルプを表示するには

Module オブジェクトの種類でサポートされているコマンドを表示するには、次のコマンドを入力します。

Appcmd.exe module /?

各コマンドの使用法を表示するには、次のコマンドを入力します。

Appcmd.exe install module /?Appcmd add module /?

モジュール リファレンス

IIS サーバーをカスタマイズする準備ができました。 副作用、機能の損失、またはセキュリティ機能の削除を回避するために、次の一覧を慎重に確認してください。

ユーティリティ モジュール

これらのモジュールは要求サービスを提供しませんが、代わりにサーバー エンジンの内部操作を支援します。

マネージド モジュール: