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

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

1. Откройте диспетчер сервера> Roles и выберите веб-сервер (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 (message:Failed to add duplicate collection element "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 готов к настройке. Внимательно ознакомьтесь со следующим списком, чтобы избежать побочных эффектов, потери компонентов или удаления функций безопасности.

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

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

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