グローバルモジュール: <globalModules>

[アーティクル]
03/25/2024

概要

<globalModules> 要素は、IIS 7 サーバーにインストールされるグローバルレベルのモジュールを定義します。 <globalModules> 要素はサーバーレベルでのみ使用できるので、モジュールをインストールすると、IIS は ApplicationHost.config ファイルのみを更新します。ネイティブモジュールをインストールするには、サーバーの管理者である必要があります。

IIS 7 では、その要求処理の大部分が、ネイティブモジュールで実装されています。サービスマネージャーを使って IIS 7 の役割サービスまたは機能をインストールすると、IIS インストーラーによって、そのモジュールのエントリが <globalModules> 要素に追加されます。たとえば、IIS 7 サーバーに基本認証役割サービスをインストールすると、インストーラーは BasicAuthenticationModule エントリを <globalModules> 要素に追加します。

サードパーティのモジュールをインストールするときは、そのモジュールのエントリを <globalModules> 要素に追加する必要があります。これは、IIS マネージャーを使って、ApplicationHost.config ファイルを手動で編集して、または AppCmd.exe コマンドラインツールを使って、行うことができます。

アプリケーションでモジュールを有効にするには、アプリケーションの <module> 要素を編集する必要があります。

互換性

バージョン	メモ
IIS 10.0	`<globalModules>` 要素は、IIS 10.0 では変更されませんでした。
IIS 8.5	`<globalModules>` 要素は、IIS 8.5 では変更されませんでした。
IIS 8.0	`<globalModules>` 要素は、IIS 8.0 では変更されませんでした。
IIS 7.5	`<globalModules>` 要素は、IIS 7.5 では変更されませんでした。
IIS 7.0	`<globalModules>` 要素が IIS 7.0 で導入されました。
IIS 6.0	該当なし

段取り

<globalModules> 要素は IIS 7 の既定のインストールに含まれています。

操作方法

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

インターネットインフォメーションサービス (IIS) マネージャーを開きます。
- Windows Server 2012 または Windows Server 2012 R2 を使用している場合:
  - タスクバーで、[サーバーマネージャー] をクリックし、[ツール]、[インターネットインフォメーションサービス (IIS) マネージャー] の順にクリックします。
- Windows 8 または Windows 8.1 を使用している場合:
  - Windows キーを押しながら文字 X を押し、[コントロールパネル] をクリックします。
  - [管理ツール] をクリックし、[インターネットインフォメーションサービス (IIS) マネージャー] をダブルクリックします。
- Windows Server 2008 または Windows Server 2008 R2 を使用している場合:
  - タスクバーで、[スタート] ボタンをクリックし、[管理ツール]、[インターネットインフォメーションサービス (IIS) マネージャー] の順にクリックします。
- Windows Vista または Windows 7 を使用している場合:
  - タスクバーで、[スタート]、[コントロールパネル] の順にクリックします。
  - [管理ツール] をダブルクリックし、[インターネットインフォメーションサービス (IIS) マネージャー] をダブルクリックします。
[接続] ウィンドウで、ネイティブモジュールを追加するサーバー接続をクリックします。
サーバーのホームページで、[モジュール] をダブルクリックします。
[操作] ウィンドウで [ネイティブモジュールの構成] をクリックします。
[ネイティブモジュールの構成] ダイアログボックスで、[登録] をクリックします。
[ネイティブモジュールの登録] ダイアログボックスで、[名前] ボックスにネイティブモジュールの名前を入力します。
[パス] ボックスに、.dll ファイルの場所のファイルシステムパスを入力するか、[参照] ボタンをクリックします
[ネイティブモジュールの構成] ダイアログボックスで、登録したネイティブモジュールのオプションを選んで、[OK] をクリックし、もう一度 [OK] をクリックします。これにより、ネイティブモジュールが実行できるようになり、Web サーバー上のサイトとアプリケーションでそれを使用できるようになります。

Note

ネイティブモジュールを実行できるようにしたくない場合は、ネイティブモジュールのオプションをオフにして、[OK] をクリックします。
必要に応じて、ネイティブモジュールが構成システムの下位レベルでオーバーライドされないようにする場合は、それをロックできます。 [モジュール] ページでモジュールを選び、[操作] ウィンドウで [ロック] をクリックします。

ネイティブモジュールを有効にする方法

インターネットインフォメーションサービス (IIS) マネージャーを開きます。
- Windows Server 2012 または Windows Server 2012 R2 を使用している場合:
  - タスクバーで、[サーバーマネージャー] をクリックし、[ツール]、[インターネットインフォメーションサービス (IIS) マネージャー] の順にクリックします。
- Windows 8 または Windows 8.1 を使用している場合:
  - Windows キーを押しながら文字 X を押し、[コントロールパネル] をクリックします。
  - [管理ツール] をクリックし、[インターネットインフォメーションサービス (IIS) マネージャー] をダブルクリックします。
- Windows Server 2008 または Windows Server 2008 R2 を使用している場合:
  - タスクバーで、[スタート] ボタンをクリックし、[管理ツール]、[インターネットインフォメーションサービス (IIS) マネージャー] の順にクリックします。
- Windows Vista または Windows 7 を使用している場合:
  - タスクバーで、[スタート]、[コントロールパネル] の順にクリックします。
  - [管理ツール] をダブルクリックし、[インターネットインフォメーションサービス (IIS) マネージャー] をダブルクリックします。
管理するサーバー、サイト、またはアプリケーションのレベルに移動します。
サーバー、サイト、またはアプリケーションのホームページで、[モジュール] をダブルクリックします。
[操作] ウィンドウで [ネイティブモジュールの構成] をクリックします。
[ネイティブモジュールの構成] ダイアログボックスで、有効にするネイティブモジュールのオプションを選んで、[OK] をクリックします。

構成

<globalModules> 要素には、<add> 要素のコレクションが含まれます。コレクション内の各要素によって、サーバーのグローバルモジュールが構成されます。

属性

なし。

子要素

要素	説明
`add`	省略可能な要素です。グローバルモジュールのコレクションにネイティブモジュールを追加します。
`clear`	省略可能な要素です。グローバルモジュールのコレクションからネイティブモジュールへのすべての参照を削除します。
`remove`	省略可能な要素です。グローバルモジュールのコレクションから特定のネイティブモジュールへの参照を削除します。

構成サンプル

次に示すのは、Web サーバーの最小インストールに含まれるすべてのモジュールのエントリを含む IIS 7 の <globalModules> セクションの例です。また、BasicAuthenticationModule に対するエントリと、ImageCopyrightModule サードパーティモジュールに対する別のものも含まれます。

<globalModules>
   <add name="UriCacheModule"
      image="%windir%\System32\inetsrv\cachuri.dll" />
   <add name="FileCacheModule"
      image="%windir%\System32\inetsrv\cachfile.dll" />
   <add name="TokenCacheModule"
      image="%windir%\System32\inetsrv\cachtokn.dll" />
   <add name="HttpCacheModule"
      image="%windir%\System32\inetsrv\cachhttp.dll" />
   <add name="StaticCompressionModule"
      image="%windir%\System32\inetsrv\compstat.dll" />
   <add name="DefaultDocumentModule"
      image="%windir%\System32\inetsrv\defdoc.dll" />
   <add name="DirectoryListingModule"
      image="%windir%\System32\inetsrv\dirlist.dll" />
   <add name="ProtocolSupportModule"
      image="%windir%\System32\inetsrv\protsup.dll" />
   <add name="StaticFileModule"
      image="%windir%\System32\inetsrv\static.dll" />
   <add name="AnonymousAuthenticationModule"
      image="%windir%\System32\inetsrv\authanon.dll" />
   <add name="RequestFilteringModule"
      image="%windir%\System32\inetsrv\modrqflt.dll" />
   <add name="CustomErrorModule"
      image="%windir%\System32\inetsrv\custerr.dll" />
   <add name="HttpLoggingModule"
      image="%windir%\System32\inetsrv\loghttp.dll" />
   <add name="RequestMonitorModule"
      image="%windir%\System32\inetsrv\iisreqs.dll" />
   <add name="BasicAuthenticationModule"
      image="%windir%\System32\inetsrv\authbas.dll" />
   <add name="ImageCopyrightModule"
      image="%windir%\System32\inetsrv\ImageCopyrightModule.dll" />
</globalModules>

サンプルコード

次の例では、ImageCopyrightModule という名前のネイティブモジュールを IIS 7 にインストールし、サーバー全体でそれを自動的に有効にしています。

AppCmd.exe

appcmd.exe install module /name:ImageCopyrightModule /image:%windir%\system32\inetsrv\imageCopyrightModule.dll

次の構文も使用できます。

appcmd.exe set config -section:system.webServer/globalModules /+"[name='ImageCopyrightModule',image='%windir%\system32\inetsrv\imageCopyrightModule.dll']" /commit:apphost

Note

AppCmd.exe を使用してこれらの設定を構成するときは、commit パラメーターを必ず apphost に設定する必要があります。これで、ApplicationHost.config ファイルの適切な場所セクションに構成設定がコミットされます。

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection globalModulesSection = config.GetSection("system.webServer/globalModules");
         ConfigurationElementCollection globalModulesCollection = globalModulesSection.GetCollection();
         ConfigurationElement addElement = globalModulesCollection.CreateElement("add");
         addElement["name"] = @"ImageCopyrightModule";
         addElement["image"] = @"%windir%\system32\inetsrv\imageCopyrightModule.dll";
         globalModulesCollection.Add(addElement);
         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim globalModulesSection As ConfigurationSection = config.GetSection("system.webServer/globalModules")
      Dim globalModulesCollection As ConfigurationElementCollection = globalModulesSection.GetCollection
      Dim addElement As ConfigurationElement = globalModulesCollection.CreateElement("add")
      addElement("name") = "ImageCopyrightModule"
      addElement("image") = "%windir%\system32\inetsrv\imageCopyrightModule.dll"
      globalModulesCollection.Add(addElement)
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var globalModulesSection = adminManager.GetAdminSection("system.webServer/globalModules", "MACHINE/WEBROOT/APPHOST");
var globalModulesCollection = globalModulesSection.Collection;

var addElement = globalModulesCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "ImageCopyrightModule";
addElement.Properties.Item("image").Value = "%windir%\\system32\\inetsrv\\imageCopyrightModule.dll";
globalModulesCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set globalModulesSection = adminManager.GetAdminSection("system.webServer/globalModules", "MACHINE/WEBROOT/APPHOST")
Set globalModulesCollection = globalModulesSection.Collection

Set addElement = globalModulesCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "ImageCopyrightModule"
addElement.Properties.Item("image").Value = "%windir%\system32\inetsrv\imageCopyrightModule.dll"
globalModulesCollection.AddElement addElement

adminManager.CommitChanges()

次の方法で共有

グローバルモジュール: <globalModules>

概要

互換性

段取り

操作方法

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

ネイティブモジュールを有効にする方法

構成

属性

子要素

構成サンプル

サンプルコード

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

フィードバック

その他のリソース

次の方法で共有

グローバル モジュール: <globalModules>

概要

互換性

段取り

操作方法

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

ネイティブ モジュールを有効にする方法

構成

属性

子要素

構成サンプル

サンプル コード

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

フィードバック

その他のリソース

グローバルモジュール: <globalModules>

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

ネイティブモジュールを有効にする方法

サンプルコード