IIS 模块概述

作者：IIS 团队 Mike Volodarsky

兼容性

介绍

IIS 7 及更高版本的 Web 服务器功能集已组件化为三十多个独立模块。

模块可以是 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 功能”对话框中，展开“Internet Information Services”并选择所有功能。
   可能需要展开某些类别以选择该类别中的所有功能。
5. 单击“确定”。

在 Windows Server 2008/R2、Windows Server 2012/R2 或 Windows Server 2016 上执行 IIS 的完整安装

1. 打开“服务器管理器”>“角色”，然后选择“Web 服务器(IIS)”。
2. 选中“Web 服务器”下的所有功能。

模块入门

要将模块添加到服务器，必须执行两个步骤：

1. 在服务器上安装模块（仅限本机模块）。
2. 在应用程序中启用模块。

第一步将模块全局注册到服务器，使其在每个服务器工作进程中可用。 由于本机代码的受信任性质，只有本机模块才需要执行此步骤，并且只有管理员才能执行。

第二步使模块能够在特定应用程序中执行，并且实际上是允许应用程序管理员控制为应用程序启用的服务器功能。 此步骤允许为每个应用程序启用已安装的本机模块和托管模块。

安装本机模块

要安装本机模块，必须使用以下选项之一向服务器注册本机模块：

• 手动编辑 IIS 配置存储。 在 IIS 7.5 及更高版本中，可以在 IIS 管理器中使用配置编辑器。
• 使用 IIS 管理器
• 使用 AppCmd.exe 命令行工具

这三个选项都会导致模块条目添加到 IIS 的 <globalModules> 配置节（只能在服务器级别设置）。 若要检查此节的内容，请打开位于的 %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 命令行工具

这三个选项都会将模块条目添加到 IIS 配置节 <modules>，可以在服务器级别和应用程序级别设置。 打开位于 %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

模块条目上还有另一个名为 PRECONDITION 的属性。 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 集成管道”。

还可以使用快捷方式使所有托管 (ASP.NET) 模块都能针对所有应用程序中的所有请求运行，无论 managedHandler 前提条件如何。 如果要使所有托管模块都能针对所有请求运行，而无需配置每个模块条目以删除 managedHandler 前提条件，请使用 部分中的 runAllManagedModulesForAllRequests<modules> 属性：

<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 (message:无法添加重复集合元素 "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]

例如，以下命令会列出为默认网站启用的模块。

%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

例如，以下命令会将“表单身份验证”模块添加到默认网站。

%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]

例如，以下命令会将“表单身份验证”模块从默认网站中移除。

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

此命令会全局移除“表单身份验证”模块。

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

获取有关每个 App Cmd.exe 命令语法的更多帮助

要显示模块对象支持的命令，请键入以下命令：

Appcmd.exe module /?

要显示每个命令的用法，请键入以下命令：

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

模块参考

IIS 服务器已经可供定制。 请仔细阅读以下列表，以避免副作用、功能丢失或移除安全功能。

实用工具模块

这些模块不会提供请求服务，而是协助服务器引擎执行其内部操作。

托管模块：