Web 制限 <webLimits>

• 概要
• 互換性
• セットアップ
• 方法
• 構成
• サンプル コード

概要

<webLimits> 要素は、TCP/IP 接続と帯域幅の制限を指定します。

ワーカー プロセスは、60 秒ごとにアイドル状態の継続時間をチェックします。現在のアイドル時間が、Windows プロセス起動サービス (WAS) によって指定されたアイドル タイムアウト値よりも長い場合、ワーカー プロセスはシャットダウンを開始します。dynamicIdleThreshold 属性に 0 以外の値を指定すると、WAS は RAM の使用量に基づいて、このアイドル タイムアウトを動的に減らします。

dynamicIdleThreshold 属性は、コミットされた物理 RAM 容量を表します。たとえば、サーバーに 2 ギガバイト (GB) の物理メモリがインストールされており、dynamicIdleThreshold 属性値を 200 に設定すると、物理 RAM の 200% (4 GB) が使用のためにコミットされます。次の表に基づくと、4 GB の中の 80%、つまり物理 RAM の 160% (3.2 GB) が割り当てられると、WAS はすべてのワーカー プロセスのアイドル タイムアウトを 50% 減らし始めます。

次の表は、dynamicIdleThreshold 値との関連で事前に指定された割合 (%) で発生するアイドル タイムアウトの減少を示します。

互換性

セットアップ

<webLimits> 要素は、IIS 7.0 の既定のインストールに含まれています。

方法

IIS 7.0 には、Web 制限を構成するためのユーザー インターフェイスはありません。Web 制限の設定をプログラムを使用して構成する方法の例については、このドキュメントの「サンプル コード」セクションを参照してください。

構成

属性

子要素

なし。

構成サンプル

次の構成サンプルでは、接続のタイムアウトを 1 分に、コミットされた物理 RAM の割合 (%) を 150 に、ヘッダーを待機するタイムアウトを 30 秒に、許可される最小のスループットを 1 秒あたり 500 バイトに設定します。

<configuration>
   <system.applicationHost>
      <webLimits connectionTimeout="00:01:00"
         dynamicIdleThreshold="150"
         headerWaitTimeout="00:00:30"
         minBytesPerSecond="500"
      />
   </system.applicationHost>

</configuration>

サンプル コード

次のコード サンプルでは、接続のタイムアウトを 1 分に、コミットされた物理 RAM の割合 (%) を 150 に、ヘッダーを待機するタイムアウトを 30 秒に、許可される最小のスループットを 1 秒あたり 500 バイトに設定します。

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/webLimits /connectionTimeout:"00:01:00" /commit:apphost
appcmd.exe set config -section:system.applicationHost/webLimits /dynamicIdleThreshold:"150" /commit:apphost
appcmd.exe set config -section:system.applicationHost/webLimits /headerWaitTimeout:"00:00:30" /commit:apphost
appcmd.exe set config -section:system.applicationHost/webLimits /minBytesPerSecond:"500" /commit:apphost

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection webLimitsSection = config.GetSection("system.applicationHost/webLimits");

         webLimitsSection["connectionTimeout"] = TimeSpan.Parse("00:01:00");
         webLimitsSection["dynamicIdleThreshold"] = 150;
         webLimitsSection["headerWaitTimeout"] = TimeSpan.Parse("00:00:30");
         webLimitsSection["minBytesPerSecond"] = 500;

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim webLimitsSection As ConfigurationSection = config.GetSection("system.applicationHost/webLimits")

      webLimitsSection("connectionTimeout") = TimeSpan.Parse("00:01:00")
      webLimitsSection("dynamicIdleThreshold") = 150
      webLimitsSection("headerWaitTimeout") = TimeSpan.Parse("00:00:30")
      webLimitsSection("minBytesPerSecond") = 500

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var webLimitsSection = adminManager.GetAdminSection("system.applicationHost/webLimits", "MACHINE/WEBROOT/APPHOST");
webLimitsSection.Properties.Item("connectionTimeout").Value = "00:01:00";
webLimitsSection.Properties.Item("dynamicIdleThreshold").Value = 150;
webLimitsSection.Properties.Item("headerWaitTimeout").Value = "00:00:30";
webLimitsSection.Properties.Item("minBytesPerSecond").Value = 500;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set webLimitsSection = adminManager.GetAdminSection("system.applicationHost/webLimits", "MACHINE/WEBROOT/APPHOST")
webLimitsSection.Properties.Item("connectionTimeout").Value = "00:01:00"
webLimitsSection.Properties.Item("dynamicIdleThreshold").Value = 150
webLimitsSection.Properties.Item("headerWaitTimeout").Value = "00:00:30"
webLimitsSection.Properties.Item("minBytesPerSecond").Value = 500

adminManager.CommitChanges()