<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>
찾은 설정을 구성하는 코드 샘플은 이 항목의 구성 세부 정보 섹션에 나열된 자식 요소를 참조하세요.