<system.webServer>

  • Artigo

Visão geral

O elemento <system.webServer> especifica o elemento raiz para muitas das definições de configuração no nível do site e no nível do aplicativo para Serviços de Informações da Internet (IIS) 7 no arquivo ApplicationHost.config e contém elementos de configuração que definem as configurações usadas pelo mecanismo e módulos do servidor Web.

Observação

Ao contrário das configurações encontradas em <system.applicationHost>, as configurações no elemento <system.webServer> podem ser delegadas.

Compatibilidade

Versão Observações
IIS 10.0 O elemento <applicationInitialization> não foi modificado no IIS 10.0.
IIS 8.5 O elemento <system.webServer> não foi modificado no IIS 8.5.
IIS 8.0 Os elementos <applicationInitialization> e <webSocket> foram adicionados como elementos filho.
IIS 7.5 O elemento <system.webServer> não foi modificado no IIS 7.5.
IIS 7.0 O elemento <system.webServer> foi introduzido no IIS 7.0.
IIS 6,0 N/D

Instalação

O elemento <system.webServer> está incluído na instalação padrão do IIS 7.

Instruções

Não há exemplos específicos para o elemento <system.webServer>. Para obter exemplos que definem as configurações encontradas dentro do elemento <system.webServer>, confira os elementos filho listados na seção detalhes da configuração deste tópico.

Configuração

O elemento <system.webServer> é definido no arquivo ApplicationHost.config, embora as configurações no elemento <system.webServer> possam ser delegadas para os arquivos Web.config.

Atributos

Nenhum.

Elementos filho

Elemento Descrição
applicationInitialization Elemento opcional.

Define as configurações de inicialização do aplicativo que são executadas proativamente antes de uma solicitação ser recebida.
asp Elemento opcional.

Define as configurações de aplicativos Active Server Pages (ASP).
caching Elemento opcional.

Define as configurações de cache de saída.
cgi Elemento opcional.

Define as configurações padrão para aplicativos CGI (Common Gateway Interface).
defaultDocument Elemento opcional.

Define as configurações para retornar um documento padrão para um navegador do cliente quando o cliente não especifica um nome de arquivo em uma solicitação.
directoryBrowse Elemento opcional.

Configura se a pesquisa no diretório está habilitada ou desabilitada no servidor Web e especifica as informações a serem incluídas em uma listagem de diretórios.
fastCgi Elemento opcional.

Contém uma coleção de definições do pool de aplicativos fastCgi.
globalModules Elemento opcional.

Especifica as definições de configuração de módulos globais em um servidor Web.
handlers Elemento opcional.

Especifica os manipuladores para processar solicitações feitas em sites e aplicativos.
httpCompression Elemento opcional.

Define as configurações de compactação HTTP de um servidor Web.
httpErrors Elemento opcional.

Configura as mensagens de erro HTTP de um servidor Web.
httpLogging Elemento opcional.

Especifica as definições de configuração de registro em log HTTP.sys.
httpProtocol Elemento opcional.

Configura os cabeçalhos de resposta personalizados e de redirecionamento a serem enviados do servidor para o cliente.
httpRedirect Elemento opcional.

Define as configurações para redirecionar as solicitações de cliente para um novo local.
httpTracing Elemento opcional.

Especifica as definições de configuração de rastreamento HTTP.sys.
isapiFilters Elemento opcional.

Especifica as definições de configuração de filtros ISAPI em um servidor Web.
management Elemento opcional.

Configura um servidor Web para gerenciamento remoto usando o Gerenciador do IIS.
modules Elemento opcional.

Especifica as definições de configuração dos módulos em um servidor Web.
odbcLogging Elemento opcional.

Configura o registro em log do Open Database Connectivity (ODBC).
security Elemento opcional.

Especifica o grupo de seções que contém as seções relacionadas à segurança.
serverRuntime Elemento opcional.

Configura os limites de solicitação de aplicativos em um servidor Web.
serverSideInclude Elemento opcional.

Especifica se as diretivas de #exec do Server-Side Include (SSI) estão desabilitadas.
staticContent Elemento opcional.

Define as configurações do manipulador de solicitação de arquivo estático.
tracing Elemento opcional.

Define as configurações de rastreamento de solicitação.
urlCompression Elemento opcional.

Configura a compactação de conteúdo estático e dinâmico.
validation Elemento opcional.

Configura o IIS 7 para detectar se um aplicativo ASP.NET configurado para ser executado no modo ISAPI precisa de qualquer migração para funcionar corretamente no modo Integrado.
webdav Elemento opcional.

Define as configurações de publicação do WebDAV.
webSocket Elemento opcional.

Configura as comunicações pelo protocolo WebSocket.

Exemplo de configuração

O exemplo de configuração a seguir define um elemento <system.webServer> simples, somente conteúdo estático.

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

Exemplo de código

Não há exemplos de código específicos para o elemento <system.webServer>. Para obter exemplos de código que definem as configurações encontradas dentro do elemento <system.webServer>, confira os elementos filho listados na seção detalhes da configuração deste tópico.