<system.webServer>

Article
03/13/2024

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.

Partager via