<system.webServer>

Articolo
07/19/2023

Panoramica

L'elemento <system.webServer> specifica l'elemento radice per molte delle impostazioni di configurazione a livello di sito e a livello di applicazione per Internet Information Services (IIS) 7 nel file ApplicationHost.config e contiene elementi di configurazione che definiscono le impostazioni usate dal motore e dai moduli del server Web.

Nota

A differenza delle impostazioni disponibili in <system.applicationHost>, le impostazioni nell'elemento <system.webServer> possono essere delegate.

Compatibilità

Versione	Note
IIS 10.0	L'elemento `<applicationInitialization>` non è stato modificato in IIS 10.0.
IIS 8,5	L'elemento `<system.webServer>` non è stato modificato in IIS 8.5.
IIS 8,0	Gli `<applicationInitialization>` elementi e `<webSocket>` sono stati aggiunti come elementi figlio.
IIS 7,5	L'elemento `<system.webServer>` non è stato modificato in IIS 7.5.
IIS 7.0	L'elemento `<system.webServer>` è stato introdotto in IIS 7.0.
IIS 6.0	N/D

Installazione

L'elemento <system.webServer> è incluso nell'installazione predefinita di IIS 7.

Procedure

Non sono presenti esempi specifici dell'elemento <system.webServer> . Per esempi che configurano le impostazioni disponibili all'interno dell'elemento <system.webServer> , vedere gli elementi figlio elencati nella sezione dettagli della configurazione di questo argomento.

Configurazione

L'elemento <system.webServer> è definito nel file ApplicationHost.config, anche se le impostazioni nell'elemento <system.webServer> possono essere delegate ai file di Web.config.

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
`applicationInitialization`	Elemento facoltativo. Configura le impostazioni per l'inizializzazione dell'applicazione eseguita in modo proattivo prima che venga ricevuta una richiesta.
`asp`	Elemento facoltativo. Configura le impostazioni per le applicazioni Active Server Pages (ASP).
`caching`	Elemento facoltativo. Configura le impostazioni della cache di output.
`cgi`	Elemento facoltativo. Configura le impostazioni predefinite per le applicazioni CGI (Common Gateway Interface).
`defaultDocument`	Elemento facoltativo. Configura le impostazioni per restituire un documento predefinito a un browser client quando il client non specifica un nome di file in una richiesta.
`directoryBrowse`	Elemento facoltativo. Configura se l'esplorazione della directory è abilitata o disabilitata nel server Web e specifica le informazioni da includere in un elenco di directory.
`fastCgi`	Elemento facoltativo. Contiene una raccolta di definizioni del pool di applicazioni fastCgi.
`globalModules`	Elemento facoltativo. Specifica le impostazioni di configurazione per i moduli globali in un server Web.
`handlers`	Elemento facoltativo. Specifica i gestori per elaborare le richieste effettuate ai siti e alle applicazioni.
`httpCompression`	Elemento facoltativo. Configura le impostazioni di compressione HTTP per un server Web.
`httpErrors`	Elemento facoltativo. Configura i messaggi di errore HTTP per un server Web.
`httpLogging`	Elemento facoltativo. Specifica le impostazioni di configurazione per la registrazione di HTTP.sys.
`httpProtocol`	Elemento facoltativo. Configura intestazioni di risposta personalizzate e di reindirizzamento da inviare dal server al client.
`httpRedirect`	Elemento facoltativo. Configura le impostazioni per reindirizzare le richieste client a una nuova posizione.
`httpTracing`	Elemento facoltativo. Specifica le impostazioni di configurazione per HTTP.sys traccia.
`isapiFilters`	Elemento facoltativo. Specifica le impostazioni di configurazione per i filtri ISAPI in un server Web.
`management`	Elemento facoltativo. Configura un server Web per la gestione remota tramite Gestione IIS.
`modules`	Elemento facoltativo. Specifica le impostazioni di configurazione per i moduli in un server Web.
`odbcLogging`	Elemento facoltativo. Configura la registrazione Open Database Connectivity (ODBC).
`security`	Elemento facoltativo. Specifica il gruppo di sezioni che contiene sezioni correlate alla sicurezza.
`serverRuntime`	Elemento facoltativo. Configura i limiti delle richieste per le applicazioni in un server Web.
`serverSideInclude`	Elemento facoltativo. Specifica se le direttive SSI (Server-side include) #exec sono disabilitate.
`staticContent`	Elemento facoltativo. Configura le impostazioni del gestore delle richieste di file statiche.
`tracing`	Elemento facoltativo. Configura le impostazioni di traccia delle richieste.
`urlCompression`	Elemento facoltativo. Configura la compressione del contenuto statico e dinamico.
`validation`	Elemento facoltativo. Configura IIS 7 per rilevare se un'applicazione ASP.NET configurata per l'esecuzione in modalità ISAPI richiede qualsiasi migrazione per funzionare correttamente in modalità integrata.
`webdav`	Elemento facoltativo. Configura le impostazioni di pubblicazione WebDAV.
`webSocket`	Elemento facoltativo. Configura le comunicazioni tramite il protocollo WebSocket.

Esempio di configurazione

L'esempio di configurazione seguente definisce un elemento semplice e statico <system.webServer> .

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

Codice di esempio

Non sono presenti esempi di codice specifici dell'elemento <system.webServer> . Per esempi di codice che configurano le impostazioni disponibili all'interno dell'elemento <system.webServer> , vedere gli elementi figlio elencati nella sezione dettagli della configurazione di questo argomento.

Condividi tramite