<system.webServer>
概要
<system.webServer> 要素を使用すると、ApplicationHost.config 内でインターネット インフォメーション サービス (IIS) 7 用の多くのサイト レベルおよびアプリケーション レベルの構成設定のためのルート要素を指定し、Web サーバー エンジンおよびモジュールで使用される設定を定義する構成要素を保持できます。
Note
<system.webServer> 要素内の設定は、<system.applicationHost> にある設定とは異なり、委任することができます。
互換性
| バージョン | メモ |
|---|---|
| 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> 要素は ApplicationHost.config ファイル内で定義されますが、<system.webServer> 要素内の設定は Web.config ファイルに委任できます。
属性
なし。
子要素
| 要素 | 説明 |
|---|---|
applicationInitialization |
省略可能な要素です。 要求が受信される前にあらかじめ実行されるアプリケーションの初期化のための設定を構成します。 |
asp |
省略可能な要素です。 Active Server Pages (ASP) アプリケーションの設定を構成します。 |
caching |
省略可能な要素です。 出力キャッシュ設定を構成します。 |
cgi |
省略可能な要素です。 Common Gateway Interface (CGI) アプリケーションの既定の設定を構成します。 |
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 |
省略可能な要素です。 Open Database Connectivity (ODBC) のログ記録を構成します。 |
security |
省略可能な要素です。 セキュリティ関連のセクションが含まれているセクション グループを指定します。 |
serverRuntime |
省略可能な要素です。 Web サーバー上でのアプリケーションの要求制限を構成します。 |
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> 要素内にある設定を構成するコード サンプルについては、このトピックの構成の詳細説明のセクションに一覧表示されている子要素を参照してください。