<system.webServer>

  • 아티클

개요

요소는 <system.webServer> ApplicationHost.config 파일의 IIS(인터넷 정보 서비스) 7에 대한 많은 사이트 수준 및 애플리케이션 수준 구성 설정의 루트 요소를 지정하고 웹 서버 엔진 및 모듈에서 사용하는 설정을 정의하는 구성 요소를 포함합니다.

참고

에 <system.applicationHost>있는 설정과 달리 요소의 <system.webServer> 설정을 위임할 수 있습니다.

호환성

버전 참고
IIS 10.0 <applicationInitialization> 요소가 IIS 10.0에서 수정되지 않았습니다.
IIS 8.5 <system.webServer> 요소가 IIS 8.5에서 수정되지 않았습니다.
IIS 8.0 <applicationInitialization> 및 <webSocket> 요소가 자식 요소로 추가되었습니다.
IIS 7.5 <system.webServer> 요소가 IIS 7.5에서 수정되지 않았습니다.
IIS 7.0 요소는 <system.webServer> IIS 7.0에서 도입되었습니다.
IIS 6.0 해당 없음

설치 프로그램

요소는 <system.webServer> IIS 7의 기본 설치에 포함됩니다.

방법

요소와 관련된 예제는 <system.webServer> 없습니다. 요소 내에서 <system.webServer> 찾은 설정을 구성하는 예제는 이 항목의 구성 세부 정보 섹션에 나열된 자식 요소를 참조하세요.

구성

요소의 설정 <system.webServer> 은 <system.webServer> Web.config 파일에 위임될 수 있지만 요소는 ApplicationHost.config 파일에 정의됩니다.

특성

없음

자식 요소

요소 Description
applicationInitialization 선택적 요소입니다.

요청을 받기 전에 사전에 수행되는 애플리케이션 초기화에 대한 설정을 구성합니다.
asp 선택적 요소입니다.

ASP(Active Server Pages) 애플리케이션에 대한 설정을 구성합니다.
caching 선택적 요소입니다.

출력 캐시 설정을 구성합니다.
cgi 선택적 요소입니다.

CGI(Common Gateway Interface) 애플리케이션에 대한 기본 설정을 구성합니다.
defaultDocument 선택적 요소입니다.

클라이언트가 요청에 파일 이름을 지정하지 않을 때 기본 문서를 클라이언트 브라우저로 반환하기 위한 설정을 구성합니다.
directoryBrowse 선택적 요소입니다.

웹 서버에서 디렉터리 검색을 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 구성하고 디렉터리 목록에 포함할 정보를 지정합니다.
fastCgi 선택적 요소입니다.

fastCgi 애플리케이션 풀 정의의 컬렉션을 포함합니다.
globalModules 선택적 요소입니다.

웹 서버의 전역 모듈에 대한 구성 설정을 지정합니다.
handlers 선택적 요소입니다.

사이트 및 애플리케이션에 대한 요청을 처리하는 처리기를 지정합니다.
httpCompression 선택적 요소입니다.

웹 서버에 대한 HTTP 압축 설정을 구성합니다.
httpErrors 선택적 요소입니다.

웹 서버에 대한 HTTP 오류 메시지를 구성합니다.
httpLogging 선택적 요소입니다.

HTTP.sys 로깅에 대한 구성 설정을 지정합니다.
httpProtocol 선택적 요소입니다.

서버에서 클라이언트로 보낼 사용자 지정 및 리디렉션 응답 헤더를 구성합니다.
httpRedirect 선택적 요소입니다.

클라이언트 요청을 새 위치로 리디렉션하기 위한 설정을 구성합니다.
httpTracing 선택적 요소입니다.

HTTP.sys 추적에 대한 구성 설정을 지정합니다.
isapiFilters 선택적 요소입니다.

웹 서버의 ISAPI 필터에 대한 구성 설정을 지정합니다.
management 선택적 요소입니다.

IIS 관리자를 사용하여 원격 관리를 위해 웹 서버를 구성합니다.
modules 선택적 요소입니다.

웹 서버의 모듈에 대한 구성 설정을 지정합니다.
odbcLogging 선택적 요소입니다.

ODBC(Open Database Connectivity) 로깅을 구성합니다.
security 선택적 요소입니다.

보안 관련 섹션이 포함된 섹션 그룹을 지정합니다.
serverRuntime 선택적 요소입니다.

웹 서버의 애플리케이션에 대한 요청 제한을 구성합니다.
serverSideInclude 선택적 요소입니다.

SSI(서버 쪽 포함) #exec 지시문을 사용하지 않도록 설정할지 여부를 지정합니다.
staticContent 선택적 요소입니다.

정적 파일 요청 처리기 설정을 구성합니다.
tracing 선택적 요소입니다.

요청 추적 설정을 구성합니다.
urlCompression 선택적 요소입니다.

정적 및 동적 콘텐츠의 압축을 구성합니다.
validation 선택적 요소입니다.

통합 모드에서 올바르게 작동하기 위해 ISAPI 모드에서 실행되도록 설정된 ASP.NET 애플리케이션에 마이그레이션이 필요한지 여부를 감지하도록 IIS 7을 구성합니다.
webdav 선택적 요소입니다.

WebDAV 게시 설정을 구성합니다.
webSocket 선택적 요소입니다.

WebSocket 프로토콜을 통한 통신을 구성합니다.

구성 샘플

다음 구성 샘플에서는 간단한 정적 콘텐츠 전용 <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>

샘플 코드

요소와 관련된 코드 샘플이 <system.webServer> 없습니다. 요소 내에서 <system.webServer> 찾은 설정을 구성하는 코드 샘플은 이 항목의 구성 세부 정보 섹션에 나열된 자식 요소를 참조하세요.