<system.webServer>
- 概要
- 互換性
- セットアップ
- 方法
- 構成
- サンプル コード
概要
<system.webServer>
要素は ApplicationHost.config ファイル内に含まれ、インターネット インフォメーション サービス (IIS) 7.0 の多くのサイトレベルおよびアプリケーションレベルの構成設定のルート要素を指定します。また、この要素には、Web サーバー エンジンおよびモジュールで使用される設定を定義する構成要素も含まれます。
注 : <system.applicationHost>
内の設定とは異なり、<system.webServer>
要素内の設定は委任できます。
互換性
IIS 7.0 | IIS 6.0 | |
---|---|---|
説明 | <system.webServer> は IIS 7.0 で新たに導入された要素です。 |
なし |
セットアップ
<system.webServer>
要素は、IIS 7.0 の既定のインストールに含まれています。
方法
<system.webServer>
要素に固有の例はありません。<system.webServer>
要素内の設定を構成する例については、このトピックの構成の詳細に関するセクションに示されている子要素の一覧を参照してください。
構成
<system.webServer>
要素は ApplicationHost.config ファイルで定義されますが、<system.webServer>
要素内の設定は Web.config ファイルに委任できます。
属性
なし。
子要素
要素 | 説明 |
---|---|
asp |
オプションの要素。 Active Server Pages (ASP) アプリケーションの設定を構成します。 |
caching |
オプションの要素。 出力キャッシュの設定を構成します。 |
cgi |
オプションの要素。 CGI (Common Gateway Interface) アプリケーションの既定の設定を構成します。 |
defaultDocument |
オプションの要素。 クライアントが要求でファイル名を指定しなかった場合に、クライアント ブラウザーに既定のドキュメントを返すための設定を構成します。 |
directoryBrowse |
オプションの要素。 Web サーバー上でディレクトリの参照を有効にするか無効にするかを構成します。また、ディレクトリの一覧に含める情報も指定します。 |
fastCgi |
オプションの要素。 fastCgi アプリケーション プール定義のコレクションが含まれます。 |
globalModules |
オプションの要素。 Web サーバー上のグローバル モジュールの構成設定を指定します。 |
handlers |
オプションの要素。 サイトおよびアプリケーションに対する要求を処理するハンドラーを指定します。 |
httpCompression |
オプションの要素。 Web サーバーの HTTP 圧縮設定を構成します。 |
httpErrors |
オプションの要素。 Web サーバーの HTTP エラー メッセージを構成します。 |
httpLogging |
オプションの要素。 HTTP.sys のログの構成設定を指定します。 |
httpProtocol |
オプションの要素。 サーバーからクライアントに送信されるカスタム ヘッダーおよびリダイレクト応答ヘッダーを構成します。 |
httpRedirect |
オプションの要素。 クライアント要求を新しい場所にリダイレクトするための設定を構成します。 |
httpTracing |
オプションの要素。 HTTP.sys のトレースの構成設定を指定します。 |
isapiFilters |
オプションの要素。 Web サーバー上の ISAPI フィルターの構成設定を指定します。 |
management |
オプションの要素。 IIS マネージャーを使用したリモート管理用に Web サーバーを構成します。 |
modules |
オプションの要素。 Web サーバー上のモジュールの構成設定を指定します。 |
odbcLogging |
オプションの要素。 ODBC (Open Database Connectivity) ログを構成します。 |
security |
オプションの要素。 セキュリティ関連のセクションを含むセクション グループを指定します。 |
serverRuntime |
オプションの要素。 Web サーバー上のアプリケーションに関する要求の制限を構成します。 |
serverSideInclude |
オプションの要素。 サーバー側インクルード (SSI) の #exec ディレクティブを無効にするかどうかを指定します。 |
staticContent |
オプションの要素。 静的ファイル要求ハンドラーの設定を構成します。 |
tracing |
オプションの要素。 要求トレースの設定を構成します。 |
urlCompression |
オプションの要素。 静的コンテンツおよび動的コンテンツの圧縮を構成します。 |
validation |
オプションの要素。 ISAPI モードで実行するようセットアップされている ASP.NET アプリケーションが、統合モードで正しく動作するために移行が必要かどうかを検出するように、IIS 7.0 を構成します。 |
構成サンプル
次の構成サンプルでは、単純な、静的コンテンツのみの <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 />
</system.webServer>
サンプル コード
<system.webServer>
要素に固有のコード サンプルはありません。<system.webServer>
要素内の設定を構成するコード サンプルについては、このトピックの構成の詳細に関するセクションに示されている子要素の一覧を参照してください。