IIS 模組概觀

由 IIS 小組、 Mike Volodarsky

相容性

簡介

IIS 7 和更新版本網頁伺服器功能集已元件化為30個以上的獨立模組。

模組是 Win32 DLL（原生模組）或元件內含的 .NET 2.0 類型（Managed 模組）。 類似於一組建置組塊，模組會新增至伺服器，以提供您應用程式所需的功能。 同樣地，您可以移除所有 IIS 模組，或取代為使用 IIS C++ API 開發的自定義模組，或熟悉的 ASP.NET 2.0 API。

本文說明常見的 IIS 模組管理工作，並詳細說明每個模組，包括其組態設定，以及模組移除對網頁伺服器的潛在影響。 使用圖形化 IIS 管理員和 AppCmd 命令行工具來提供管理範例。

必要條件

若要遵循本檔中的步驟，最好是執行 IIS 的完整安裝。

在 Windows Vista、Windows 7、Windows 8、Windows 10 或 Windows 11 上執行 IIS 的完整安裝

1. 按一下 [開始]，然後按一下 [控制台]。
2. 在 控制台 中，按兩下 [程式]。
3. 按一下 [程式和功能] 下的 [開啟或關閉 Windows 功能]。
4. 在 [Windows 功能] 對話框中，展開 [網際網路資訊服務]，然後選取所有功能。
   您可能需要展開某些類別，以選取該類別中的所有功能。
5. 按一下 [確定]。

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

1. 開啟 [伺服器管理員>][角色]，然後選取 [Web 伺服器] [IIS]。
2. 檢查網頁伺服器下的所有功能。

模組用戶入門

若要將模組新增至伺服器，您必須執行兩個步驟：

1. 在伺服器上安裝模組（僅限原生模組）。
2. 在應用程式中啟用模組。

第一個步驟會向伺服器全域註冊模組，使其可在每一個伺服器背景工作進程內使用。 只有原生模組才需要因為原生程式碼的受信任本質而使用，而且只能供系統管理員使用。

第二個步驟可讓模組在特定應用程式中執行，並有效地允許應用程式系統管理員控制為應用程式啟用的伺服器功能。 此步驟可讓每個應用程式同時啟用已安裝的原生模組和受控模組。

安裝原生模組

若要安裝原生模組，必須使用下列其中一個選項向伺服器註冊：

• 手動編輯 IIS 組態存放區。 在 IIS 7.5 和更新版本中，您可以使用 IIS 管理員中的組態編輯器。
• 使用 IIS 管理員
• 使用AppCmd.exe命令行工具

這三個選項都會導致模組專案新增至 <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 目錄中提供實作，以直接在應用程式中納入其Managed模組。

若要啟用模組，請執行下列其中一項：

• 手動編輯 IIS 組態存放區，以全域方式啟用伺服器上所有應用程式的模組，或位於您要啟用此模組之每個應用程式內的特定 web.config 檔案中。 在 IIS 7.5 或更新版本中，您可以使用組態編輯器。
• 使用 IIS 管理員
• 使用 AppCmd.exe 命令行工具

這三個選項都會將模組專案新增至 <modules> IIS 組態區段，這可以在伺服器層級和應用層級設定。 開啟 位於 %windir%\system32\inetsrv\config\applicationhost.config的根組態檔，並搜尋字串 「<modules>」，以檢查本節的內容。

不同於原生模組，受控模組不需要將專案新增至 <globalModules> 組態區段。

安裝完整的 IIS 之後，組態區段會包含每個隨附於 IIS 的模組專案（同時受控和原生）。 專案表示伺服器上所有應用程式預設都會啟用所有這些模組。 本節中的每個項目都會指定先前安裝在伺服器上的原生模組名稱，或 Managed 模組的名稱和 .NET 類型：

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

</modules>

停用應用程式中的模組

如果模組不再在應用程式中使用，或您想要將模組取代為另一個模組，請停用模組。 若要停用模組，請從 <modules> 您不希望此模組執行的特定應用程式的組態集合中移除對應的模組專案。 如果模組是在伺服器層級啟用，請將其移除，以在伺服器上的所有應用程式中預設停用它。 使用下列其中一個選項來移除伺服器層級的模組：

• 在應用程式中手動編輯 <system.webServer>/<modules> 組態區段。
• 使用 IIS 管理員。
• 使用AppCmd.exe命令行工具。

從應用程式移除模組之後，該模組就不會在該應用程式中使用中。 不過，如果模組是原生模組，它仍會載入伺服器背景工作進程，而且可能供未移除它的其他應用程式使用。

前置條件

模組專案上有另一個稱為前置條件的屬性。 IIS 核心引擎會使用前置條件來判斷何時啟用特定模組。 例如，效能原因可能會判斷您只想要針對也移至受控處理程式的要求執行 Managed 模組。 下列範例中的前置條件 （precondition=“managedHandler”） 只會針對 Managed 處理程式所處理的要求啟用窗體驗證模組，例如對 .aspx 或 .asmx 檔案的要求：

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

如果您移除屬性前置條件=“managedHandler”，Forms Authentication 也適用於受管理處理程式未提供的內容，例如.html、.jpg、.doc，但也適用於傳統 ASP （.asp） 或 PHP （.php） 延伸模組。 如需讓 ASP.NET 模組針對所有內容執行範例，請參閱<如何利用 IIS 整合管線>。

您也可以使用快捷方式來啟用所有 Managed （ASP.NET） 模組，針對應用程式中的所有要求執行，而不論 「managedHandler」 前置條件為何。 若要讓所有 Managed 模組都能夠針對所有要求執行，而不需設定每個模組專案來移除 「managedHandler」 前置條件，請使用 區段中的 <modules> runAllManagedModulesForAllRequests 屬性：

<modules runAllManagedModulesForAllRequests="true"/>

當您使用這個屬性時，「managedHandler」 前置條件沒有任何作用，而且所有 Managed 模組都會針對所有要求執行。

使用 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

若要取得每個應用程式Cmd.exe命令語法的更多說明

若要顯示 Module 物件上支援的命令，請輸入下列命令：

Appcmd.exe module /?

若要顯示每個命令的使用方式，請輸入下列命令：

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

模組參考

IIS 伺服器已準備好進行自定義。 請仔細閱讀下列清單，以避免副作用、功能遺失或移除安全性功能。

公用程式模組

這些模組不會提供要求服務，而是會協助伺服器引擎進行其內部作業。

受控模組：