<system.webServer>

  • Статья

Общие сведения

Элемент <system.webServer> задает корневой элемент для многих параметров конфигурации уровня сайта и приложения для служб IIS 7 в файле ApplicationHost.config и содержит элементы конфигурации, определяющие параметры, используемые подсистемой и модулями веб-сервера.

Примечание

В отличие от параметров, которые находятся в <system.applicationHost>, параметры в элементе <system.webServer> можно делегировать.

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

Версия Примечания
IIS 10.0 Элемент <applicationInitialization> не был изменен в IIS 10.0.
IIS 8,5 Элемент <system.webServer> не был изменен в IIS 8.5.
IIS 8,0 Элементы <applicationInitialization> и <webSocket> были добавлены в качестве дочерних элементов.
IIS 7,5 Элемент <system.webServer> не был изменен в IIS 7.5.
IIS 7.0 Элемент <system.webServer> появился в IIS 7.0.
IIS 6,0 Н/Д

Настройка

Элемент <system.webServer> включен в установку iis 7 по умолчанию.

Инструкции

Примеры, относящиеся к элементу , <system.webServer> отсутствуют. Примеры настройки параметров, которые находятся в элементе <system.webServer> , см. в разделе дочерних элементов, перечисленных в разделе сведений о конфигурации этого раздела.

Конфигурация

Элемент <system.webServer> определяется в файле ApplicationHost.config, хотя параметры в <system.webServer> элементе можно делегировать Web.config файлам.

Атрибуты

Отсутствует.

Дочерние элементы

Элемент Описание
applicationInitialization Необязательный элемент.

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

Настраивает параметры для приложений ASP.
caching Необязательный элемент.

Настраивает параметры кэша вывода.
cgi Необязательный элемент.

Настраивает параметры по умолчанию для приложений CGI.
defaultDocument Необязательный элемент.

Настраивает параметры возврата документа по умолчанию в браузер клиента, если клиент не указывает имя файла в запросе.
directoryBrowse Необязательный элемент.

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

Содержит коллекцию определений пула приложений fastCgi.
globalModules Необязательный элемент.

Задает параметры конфигурации для глобальных модулей на веб-сервере.
handlers Необязательный элемент.

Задает обработчики для обработки запросов к сайтам и приложениям.
httpCompression Необязательный элемент.

Настраивает параметры сжатия HTTP для веб-сервера.
httpErrors Необязательный элемент.

Настраивает сообщения об ошибках HTTP для веб-сервера.
httpLogging Необязательный элемент.

Задает параметры конфигурации для ведения журнала HTTP.sys.
httpProtocol Необязательный элемент.

Настраивает пользовательские заголовки ответов и заголовки ответов перенаправления для отправки с сервера клиенту.
httpRedirect Необязательный элемент.

Настраивает параметры для перенаправления клиентских запросов в новое расположение.
httpTracing Необязательный элемент.

Задает параметры конфигурации для трассировки HTTP.sys.
isapiFilters Необязательный элемент.

Задает параметры конфигурации для фильтров ISAPI на веб-сервере.
management Необязательный элемент.

Настраивает веб-сервер для удаленного управления с помощью диспетчера IIS.
modules Необязательный элемент.

Задает параметры конфигурации для модулей на веб-сервере.
odbcLogging Необязательный элемент.

Настраивает ведение журнала ODBC.
security Необязательный элемент.

Указывает группу разделов, содержащую разделы, связанные с безопасностью.
serverRuntime Необязательный элемент.

Настраивает ограничения запросов для приложений на веб-сервере.
serverSideInclude Необязательный элемент.

Указывает, отключены ли директивы SSI #exec на стороне сервера.
staticContent Необязательный элемент.

Настраивает параметры обработчика запросов статических файлов.
tracing Необязательный элемент.

Настраивает параметры трассировки запросов.
urlCompression Необязательный элемент.

Настраивает сжатие статического и динамического содержимого.
validation Необязательный элемент.

Настраивает IIS 7, чтобы определить, требуется ли миграция приложения ASP.NET, настроенного для работы в режиме ISAPI, для правильной работы в режиме интеграции.
webdav Необязательный элемент.

Настраивает параметры публикации WebDAV.
webSocket Необязательный элемент.

Настраивает обмен данными по протоколу WebSocket.

Образец конфигурации

В следующем примере конфигурации определяется простой элемент, доступный только <system.webServer> для статического содержимого.

<system.webServer>
   <asp />
   <caching enabled="true" enableKernelCache="true" />
   <cgi />
   <defaultDocument enabled="true">
      <files>
         <add value="Default.htm" />
         <add value="Index.htm" />
         <add value="Index.html" />
      </files>
   </defaultDocument>
   <directoryBrowse enabled="false" />
   <fastCgi />
   <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" />
   </globalModules>
   <httpCompression directory="%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files">
      <scheme name="gzip" dll="%Windir%\system32\inetsrv\gzip.dll" />
      <staticTypes>
         <add mimeType="text/*" enabled="true" />
         <add mimeType="message/*" enabled="true" />
         <add mimeType="application/javascript" enabled="true" />
         <add mimeType="*/*" enabled="false" />
      </staticTypes>
   </httpCompression>
   <httpErrors>
      <error statusCode="401" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="401.htm" />
      <error statusCode="403" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="403.htm" />
      <error statusCode="404" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="404.htm" />
      <error statusCode="405" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="405.htm" />
      <error statusCode="406" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="406.htm" />
      <error statusCode="412" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="412.htm" />
      <error statusCode="500" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="500.htm" />
      <error statusCode="501" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="501.htm" />
      <error statusCode="502" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="502.htm" />
   </httpErrors>
   <httpLogging dontLog="false" />
   <httpProtocol />
   <httpRedirect />
   <httpTracing />
   <isapiFilters />
   <odbcLogging />
   <security>
      <access sslFlags="None" />
      <applicationDependencies />
      <authentication>
         <anonymousAuthentication enabled="true" userName="IUSR" />
         <basicAuthentication />
         <clientCertificateMappingAuthentication />
         <digestAuthentication />
         <iisClientCertificateMappingAuthentication />
         <windowsAuthentication />
      </authentication>
      <authorization />
      <ipSecurity />
      <isapiCgiRestriction notListedIsapisAllowed="false" notListedCgisAllowed="false">
         <clear />
      </isapiCgiRestriction>
      <requestFiltering>
         <fileExtensions allowUnlisted="true" applyToWebDAV="true" />
         <verbs allowUnlisted="true" applyToWebDAV="true" />
         <hiddenSegments applyToWebDAV="true">
            <add segment="Web.config" />
         </hiddenSegments>
      </requestFiltering>
   </security>
   <serverRuntime />
   <serverSideInclude />
   <staticContent lockAttributes="isDocFooterFileName">
      <mimeMap fileExtension=".png" mimeType="image/gif" />
      <mimeMap fileExtension=".htm" mimeType="text/html" />
      <mimeMap fileExtension=".html" mimeType="text/html" />
      <mimeMap fileExtension=".jpeg" mimeType="image/jpeg" />
      <mimeMap fileExtension=".png" mimeType="image/jpeg" />
      <mimeMap fileExtension=".js" mimeType="application/x-javascript" />
      <mimeMap fileExtension=".png" mimeType="image/png" />
      <mimeMap fileExtension=".txt" mimeType="text/plain" />
   </staticContent>
   <tracing>
      <traceFailedRequests />
      <traceProviderDefinitions />
   </tracing>
   <urlCompression />
   <validation />
   <webSocket />
</system.webServer>

Пример кода

Примеры кода, относящиеся к элементу <system.webServer> , отсутствуют. Примеры кода, которые настраивают параметры, находящиеся в элементе <system.webServer> , см. в разделе дочерних элементов, перечисленных в разделе сведений о конфигурации этого раздела.