<system.webServer>

  • Article

Vue d’ensemble

L’élément <system.webServer> spécifie l’élément racine de la plupart des paramètres au niveau du site et au niveau de l’application pour Internet Information Services (IIS) 7 dans le fichier ApplicationHost.config. Il englobe des éléments de configuration qui définissent les paramètres utilisés par le moteur et les modules du serveur web.

Remarque

À la différence des paramètres présents dans <system.applicationHost>, ceux de l’élément <system.webServer> peuvent être délégués.

Compatibilité

Version Notes
IIS 10.0 L’élément <applicationInitialization> n’a fait l’objet d’aucune modification dans IIS 10.0.
IIS 8.5 L’élément <system.webServer> n’a fait l’objet d’aucune modification dans IIS 8.5.
IIS 8.0 Les éléments <applicationInitialization> et <webSocket> ont été ajoutés en tant qu’éléments enfants.
IIS 7.5 L’élément <system.webServer> n’a fait l’objet d’aucune modification dans IIS 7.5.
IIS 7.0 L’élément <system.webServer> a été introduit dans IIS 7.0.
IIS 6.0 S/O

Programme d’installation

L’élément <system.webServer> est inclus dans l’installation par défaut d’IIS 7.

Procédure

Il n’existe aucun exemple spécifique à l’élément <system.webServer>. Pour accéder à des exemples de configurations présentes dans l’élément <system.webServer>, consultez la liste des éléments enfants dans la section Informations de configuration de cet article.

Configuration

L’élément <system.webServer> est défini dans le fichier ApplicationHost.config. Toutefois, les paramètres de l’élément <system.webServer> peuvent être délégués aux fichiers Web.config.

Attributs

Aucune.

Éléments enfants

Élément Description
applicationInitialization Élément facultatif.

Configure les paramètres d’initialisation d’application qui sont exécutés de manière proactive avant la réception d’une requête.
asp Élément facultatif.

Configure les paramètres des applications ASP (Active Server Pages).
caching Élément facultatif.

Configure les paramètres du cache de sortie.
cgi Élément facultatif.

Configure les paramètres par défaut des applications CGI (Common Gateway Interface).
defaultDocument Élément facultatif.

Configure les paramètres de renvoi d’un document par défaut à un navigateur client lorsque le client ne spécifie pas de nom de fichier dans une requête.
directoryBrowse Élément facultatif.

Active ou désactive l’exploration des répertoires sur le serveur web et spécifie les informations à inclure dans un répertoire.
fastCgi Élément facultatif.

Contient une collection de définitions de pool d’applications fastCgi.
globalModules Élément facultatif.

Spécifie les paramètres des modules globaux d’un serveur web.
handlers Élément facultatif.

Spécifie les gestionnaires de traitement des requêtes adressées aux sites et aux applications.
httpCompression Élément facultatif.

Configure les paramètres de compression HTTP d’un serveur web.
httpErrors Élément facultatif.

Configure la gestion des messages d’erreur HTTP d’un serveur web.
httpLogging Élément facultatif.

Spécifie les paramètres de journalisation HTTP.sys.
httpProtocol Élément facultatif.

Configure les en-têtes de réponse personnalisés et de redirection à transmettre du serveur au client.
httpRedirect Élément facultatif.

Configure les paramètres de redirection des requêtes client vers un nouvel emplacement.
httpTracing Élément facultatif.

Spécifie les paramètres de traçage HTTP.sys.
isapiFilters Élément facultatif.

Spécifie les paramètres des filtres ISAPI d’un serveur web.
management Élément facultatif.

Configure un serveur web de gestion à distance à l’aide du Gestionnaire IIS.
modules Élément facultatif.

Spécifie les paramètres des modules d’un serveur web.
odbcLogging Élément facultatif.

Configure la journalisation ODBC (Open Database Connectivity).
security Élément facultatif.

Spécifie le groupe de sections qui contient les sections liées à la sécurité.
serverRuntime Élément facultatif.

Configure les limites relatives aux requêtes pour les applications d’un serveur web.
serverSideInclude Élément facultatif.

Spécifie si les directives #exec du texte inséré par le serveur (SSI) sont désactivées.
staticContent Élément facultatif.

Configure les paramètres du gestionnaire de requêtes de fichiers statiques.
tracing Élément facultatif.

Configure les paramètres de traçage des requêtes.
urlCompression Élément facultatif.

Configure la compression du contenu statique et dynamique.
validation Élément facultatif.

Configure IIS 7 pour détecter si une application ASP.NET configurée pour s’exécuter en mode ISAPI nécessite une migration pour fonctionner correctement en mode intégré.
webdav Élément facultatif.

Configure les paramètres de publication WebDAV.
webSocket Élément facultatif.

Configure les communications via le protocole WebSocket.

Exemple Configuration

L’exemple de configuration suivant définit un élément <system.webServer> de contenu statique simple.

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

Exemple de code

Il n’existe aucun exemple de code spécifique à l’élément <system.webServer>. Pour accéder à des exemples de code de configurations présentes dans l’élément <system.webServer>, consultez la liste des éléments enfants dans la section Informations de configuration de cet article.