Общие сведения о модулях IIS

Команда IIS, Майк Володарский

Совместимость

Введение

Набор функций веб-сервера IIS 7 и выше разбит на более чем тридцать независимых модулей.

Модуль — это библиотека DLL Win32 (собственный модуль) или тип .NET 2.0, содержащийся в сборке (управляемый модуль). Как и в наборе стандартных блоков, модули добавляются на сервер, чтобы предоставить необходимые функциональные возможности для приложений. Аналогичным образом все модули IIS можно удалить или заменить пользовательскими модулями, разработанными с помощью API IIS C++ или знакомых api ASP.NET 2.0.

В этой статье описываются распространенные задачи управления модулями IIS, а также сведения о каждом модуле, включая параметры конфигурации и потенциальное влияние удаления модуля на веб-сервере. Примеры управления предоставляются с помощью графического диспетчера IIS и средства командной строки AppCmd .

Необходимые условия

Чтобы выполнить действия, описанные в этом документе, рекомендуется выполнить полную установку IIS.

Выполнение полной установки IIS в Windows Vista, Windows 7, Windows 8, Windows 10 или Windows 11

1. Нажмите кнопку "Пуск " и нажмите кнопку "Панель управления".
2. На панели управления щелкните "Программы".
3. В разделе "Программы и компоненты" щелкните "Включить или отключить функции Windows".
4. В диалоговом окне "Компоненты Windows" разверните Службы Internet Information Services и выберите все компоненты.
   Возможно, потребуется развернуть некоторые категории, чтобы выбрать все функции в этой категории.
5. Нажмите кнопку ОК.

Выполнение полной установки IIS в Windows Server 2008/R2, Windows Server 2012/R2 или Windows Server 2016

1. Откройтероли> серверов и выберите веб-сервер (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.

Чтобы включить модуль, выполните одно из следующих действий.

• Вручную измените хранилище конфигураций IIS, чтобы включить модуль для всех приложений на сервере или в определенном web.config файле, расположенном в каждом приложении, для которого необходимо включить этот модуль. В IIS 7.5 или более поздней версии можно использовать редактор конфигурации.
• Использование диспетчера IIS
• Использование средства командной строки AppCmd.exe

Все три этих параметра добавляют запись <modules> модуля в раздел конфигурации IIS, который можно задать как на уровне сервера, так и на уровне приложения. Изучите содержимое этого раздела, открыв корневой файл конфигурации, расположенный в %windir%\system32\inetsrv\config\applicationhost.config, и найдите строку "<модули>".

В отличие от собственных модулей, управляемый модуль не требует добавления записи в <раздел конфигурации globalModules> .

После полной установки IIS раздел конфигурации содержит запись для каждого модуля (как управляемого, так и собственного), который поставляется с IIS. Запись указывает, что все эти модули включены по умолчанию для всех приложений на сервере. Каждая запись в этом разделе указывает имя собственного модуля, который ранее был установлен на сервере, или имя и тип .NET управляемого модуля:

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

</modules>

Отключение модуля в приложении

Отключите модуль, если этот модуль больше не используется в приложении, или если вы хотите заменить его другим модулем. Чтобы отключить модуль, удалите соответствующую запись модуля из <modules> коллекции конфигураций для определенного приложения, в котором этот модуль не будет выполняться. Если модуль включен на уровне сервера, удалите его, чтобы отключить его во всех приложениях на сервере по умолчанию. Используйте один из следующих параметров, чтобы удалить модуль на уровне сервера:

• Вручную редактируйте в приложении раздел конфигурации <system.webServer>/<modules>.
• Используйте диспетчер IIS.
• Используйте средство командной строки AppCmd.exe .

После удаления модуля из приложения он не будет активным в этом приложении. Однако если модуль является собственным, он по-прежнему будет загружен в рабочий процесс сервера и может использоваться другими приложениями, которые не удалили его.

Предпосылки

Существует еще один атрибут записи модуля, называющийся «предварительное условие». Ядро IIS использует предварительные условия для определения времени включения конкретного модуля. Причины производительности, например, могут определить, что требуется выполнить только управляемые модули для запросов, которые также отправляются в управляемый обработчик. Условие в следующем примере (предварительные условия="managedHandler") включает только модуль проверки подлинности форм для запросов, которые также обрабатываются управляемым обработчиком, например запросы к .aspx или ASMX-файлам:

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

Если удалить условие атрибута="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 в поле поиска и нажмите клавишу ВВОД.
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]

Например, следующая команда содержит модули, включенные для веб-сайта по умолчанию.

%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

Например, следующая команда добавляет модуль проверки подлинности forms на веб-сайт по умолчанию.

%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 готов к настройке. Внимательно ознакомьтесь со следующим списком, чтобы избежать побочных эффектов, потери компонентов или удаления функций безопасности.

Модули служебной программы

Эти модули не предоставляют службы запросов, а помогают подсистеме сервера выполнять внутреннюю операцию.

Управляемые модули: