<system.webServer>

Artikel
03/15/2024

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

Freigeben über