<system.webServer>

  • Artículo

Información general

El elemento <system.webServer> especifica el elemento raíz para muchos de los valores de configuración de nivel de sitio y de aplicación para Internet Information Services (IIS) 7 en el archivo ApplicationHost.config y contiene elementos de configuración que definen la configuración usada por el motor y los módulos del servidor web.

Nota:

A diferencia de la configuración que se encuentra en <system.applicationHost>, se puede delegar la configuración del elemento <system.webServer>.

Compatibilidad

Versión Notas
IIS 10.0 El elemento <applicationInitialization> no se modificó en IIS 10.0.
IIS 8.5 El elemento <system.webServer> no se modificó en IIS 8.5.
IIS 8.0 Los elementos <applicationInitialization> y <webSocket> se agregaron como elementos secundarios.
IIS 7.5 El elemento <system.webServer> no se modificó en IIS 7.5.
IIS 7.0 El elemento <system.webServer> se introdujo en IIS 7.0.
IIS 6,0 N/D

Configuración

El elemento <system.webServer> se incluye en la instalación predeterminada de IIS 7.

Procedimientos

No hay ejemplos específicos del elemento <system.webServer>. Para obtener ejemplos que configuran las opciones que se encuentran en el elemento <system.webServer>, vea los elementos secundarios que aparecen en la sección detalles de configuración de este tema.

Configuración

El elemento <system.webServer> se define en el archivo ApplicationHost.config, aunque la configuración del elemento <system.webServer> se puede delegar en archivos Web.config.

Atributos

Ninguno.

Elementos secundarios

Elemento Descripción
applicationInitialization Elemento opcional.

Configura las opciones de inicialización de aplicaciones que se realizan de forma proactiva antes de recibir una solicitud.
asp Elemento opcional.

Configura las opciones de las aplicaciones de Active Server Pages (ASP).
caching Elemento opcional.

Configura las opciones de caché de salida.
cgi Elemento opcional.

Configura los valores predeterminados para las aplicaciones de interfaz CGI.
defaultDocument Elemento opcional.

Configura las opciones para devolver un documento predeterminado a un explorador cliente cuando el cliente no especifica un nombre de archivo en una solicitud.
directoryBrowse Elemento opcional.

Configura si la exploración de directorios está habilitada o deshabilitada en el servidor web y especifica la información que se va a incluir en una lista de directorios.
fastCgi Elemento opcional.

Contiene una colección de definiciones de grupo de aplicaciones fastCgi.
globalModules Elemento opcional.

Especifica los valores de configuración de los módulos globales en un servidor web.
handlers Elemento opcional.

Especifica controladores para procesar solicitudes realizadas a sitios y aplicaciones.
httpCompression Elemento opcional.

Configura las opciones de compresión HTTP para un servidor web.
httpErrors Elemento opcional.

Configura los mensajes de error HTTP para un servidor web.
httpLogging Elemento opcional.

Especifica los valores de configuración para el registro HTTP.sys.
httpProtocol Elemento opcional.

Configura encabezados de respuesta personalizados y de redirección que se enviarán desde el servidor al cliente.
httpRedirect Elemento opcional.

Configura las opciones para redirigir las solicitudes de cliente a una nueva ubicación.
httpTracing Elemento opcional.

Especifica los valores de configuración para el seguimiento HTTP.sys.
isapiFilters Elemento opcional.

Especifica los valores de configuración de los filtros ISAPI en un servidor web.
management Elemento opcional.

Configura un servidor web para la administración remota mediante el Administrador de IIS.
modules Elemento opcional.

Especifica los valores de configuración de los módulos en un servidor web.
odbcLogging Elemento opcional.

Configura el registro de conectividad abierta de bases de datos (ODBC).
security Elemento opcional.

Especifica el grupo de secciones que contiene secciones relacionadas con la seguridad.
serverRuntime Elemento opcional.

Configura los límites de solicitud para las aplicaciones en un servidor web.
serverSideInclude Elemento opcional.

Especifica si las directivas de #exec del lado servidor incluyen (SSI).
staticContent Elemento opcional.

Configura los valores del controlador de solicitudes de archivos estáticos.
tracing Elemento opcional.

Configura los valores de seguimiento de solicitudes.
urlCompression Elemento opcional.

Configura la compresión del contenido estático y dinámico.
validation Elemento opcional.

Configura IIS 7 para detectar si una aplicación de ASP.NET configurada para ejecutarse en modo ISAPI necesita cualquier migración para funcionar correctamente en modo integrado.
webdav Elemento opcional.

Configura las opciones de publicación de WebDAV.
webSocket Elemento opcional.

Configura las comunicaciones a través del protocolo WebSocket.

Ejemplo de configuración

En el ejemplo de configuración siguiente se define un elemento simple de solo contenido estático <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>

Código de ejemplo

No hay ejemplos de código específicos del elemento <system.webServer>. Para obtener ejemplos de código que configuran las opciones que se encuentran en el elemento <system.webServer>, vea los elementos secundarios que aparecen en la sección detalles de configuración de este tema.