<system.webServer>

  • Artikel

Übersicht

Das <system.webServer>-Element gibt das Stammelement für viele Konfigurationseinstellungen auf Website- und Anwendungsebene für Internetinformationsdienste 7 (Internet Information Services, IIS) in der Datei „ApplicationHost.config“ an und enthält Konfigurationselemente, die die vom Webservermodul und von Modulen verwendeten Einstellungen definieren.

Hinweis

Im Gegensatz zu Einstellungen in <system.applicationHost> können Einstellungen im <system.webServer>-Element delegiert werden.

Kompatibilität

Version Hinweise
IIS 10.0 Das <applicationInitialization>-Element wurde in IIS 10.0 nicht geändert.
IIS 8.5 Das <system.webServer>-Element wurde in IIS 8.5 nicht geändert.
IIS 8.0 Die <applicationInitialization>- und <webSocket>-Elemente wurden als untergeordnete Elemente hinzugefügt.
IIS 7.5 Das <system.webServer>-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0 Das <system.webServer>-Element wurde in IIS 7.0 eingeführt.
IIS 6.0 N/V

Setup

Das <system.webServer>-Element ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Es gibt keine spezifischen Beispiele für das <system.webServer>-Element. Beispiele zum Konfigurieren der Einstellungen im <system.webServer>-Element finden Sie in den Beschreibungen der untergeordneten Elemente, die im Abschnitt Konfigurationsdetails dieses Themas aufgeführt sind.

Konfiguration

Das <system.webServer>-Element wird in der Datei „ApplicationHost.config“ definiert, Einstellungen im <system.webServer>-Element können jedoch an Web.config-Dateien delegiert werden.

Attribute

Keine

Untergeordnete Elemente

Element Beschreibung
applicationInitialization Optionales Element.

Konfiguriert Einstellungen für die Anwendungsinitialisierung, die vor dem Empfang einer Anforderung proaktiv ausgeführt wird.
asp Optionales Element.

Konfiguriert Einstellungen für ASP-Anwendungen (Active Server Pages).
caching Optionales Element.

Konfiguriert Einstellungen für den Ausgabecache.
cgi Optionales Element.

Konfiguriert Standardeinstellungen für CGI-Anwendungen (Common Gateway Interface, gemeinsame Gatewayschnittstelle).
defaultDocument Optionales Element.

Konfiguriert Einstellungen zum Zurückgeben eines Standarddokuments an einen Clientbrowser, wenn der Client in einer Anforderung keinen Dateinamen angibt.
directoryBrowse Optionales Element.

Konfiguriert, ob die Verzeichnissuche auf dem Webserver aktiviert oder deaktiviert ist, und gibt die Informationen an, die in eine Verzeichnisauflistung eingeschlossen werden sollen.
fastCgi Optionales Element.

Enthält eine Sammlung von FastCGI-Anwendungspooldefinitionen.
globalModules Optionales Element.

Legt Konfigurationseinstellungen für globale Module auf einem Webserver fest.
handlers Optionales Element.

Legt Handler zum Verarbeiten von Anforderungen an Websites und Anwendungen fest.
httpCompression Optionales Element.

Konfiguriert HTTP-Komprimierungseinstellungen für einen Webserver.
httpErrors Optionales Element.

Konfiguriert HTTP-Fehlermeldungen für einen Webserver.
httpLogging Optionales Element.

Legt Konfigurationseinstellungen für die HTTP.sys-Protokollierung fest.
httpProtocol Optionales Element.

Konfiguriert benutzerdefinierte Header und Umleitungsantwortheader, die vom Server an den Client gesendet werden sollen.
httpRedirect Optionales Element.

Konfiguriert Einstellungen für die Umleitung von Clientanforderungen an einen neuen Speicherort.
httpTracing Optionales Element.

Legt Konfigurationseinstellungen für die HTTP.sys-Ablaufverfolgung fest.
isapiFilters Optionales Element.

Legt Konfigurationseinstellungen für ISAPI-Filter auf einem Webserver fest.
management Optionales Element.

Konfiguriert einen Webserver für die Remoteverwaltung mithilfe von IIS-Manager.
modules Optionales Element.

Legt Konfigurationseinstellungen für Module auf einem Webserver fest.
odbcLogging Optionales Element.

Konfiguriert die ODBC-Protokollierung (Open Database Connectivity).
security Optionales Element.

Legt die Abschnittsgruppe fest, die sicherheitsbezogene Abschnitte enthält.
serverRuntime Optionales Element.

Konfiguriert Anforderungsgrenzwerte für Anwendungen auf einem Webserver.
serverSideInclude Optionales Element.

Legt fest, ob #exec-Anweisungen für serverseitige Includes (SSI) deaktiviert sind.
staticContent Optionales Element.

Konfiguriert Anforderungshandlereinstellungen für statische Dateien.
tracing Optionales Element.

Konfiguriert Einstellungen für die Anforderungsablaufverfolgung.
urlCompression Optionales Element.

Konfiguriert die Komprimierung statischer und dynamischer Inhalte.
validation Optionales Element.

Konfiguriert IIS 7 zur Erkennung von ASP.NET-Anwendungen, die zur Ausführung im ISAPI-Modus eingerichtet sind und eine Migration erfordern, damit sie im integrierten Modus korrekt funktionieren.
webdav Optionales Element.

Konfiguriert WebDAV-Veröffentlichungseinstellungen.
webSocket Optionales Element.

Konfiguriert die Kommunikation über das WebSocket-Protokoll.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel wird ein einfaches <system.webServer>-Element definiert, das nur statischen Inhalt aufweist.

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

Beispielcode

Es gibt keine spezifischen Codebeispiele für das <system.webServer>-Element. Codebeispiele zum Konfigurieren der Einstellungen im <system.webServer>-Element finden Sie in den Beschreibungen der untergeordneten Elemente, die im Abschnitt Konfigurationsdetails dieses Themas aufgeführt sind.