アプリケーション プールの追加 <add>

概要

<applicationPools> 要素の <add> 要素は、IIS 7 以降のアプリケーション プールの構成設定を制御します。 ApplicationHost.config ファイルに、IIS サーバーで実行するアプリケーション プールごとに <add> 要素を作成します。

<add> 要素には、パイプライン処理モードを構成する属性と子要素、およびアプリケーション プール内のワーカー プロセスが着信要求に使用する .NET Framework のバージョンを含めることができます。 この要素には、アプリケーション プールの ID、パフォーマンス、正常性、およびリサイクル アプリケーション プールの設定を構成する子要素も含まれています。

IIS 7 以降で新しいアプリケーション プールを作成するときは、少なくともアプリケーション プールに一意の名前を割り当てる必要があります。 アプリケーション プールを使用するアプリケーションに、必要に応じて他のすべてのプロパティを構成します。

IIS 7.5 以降の新機能

IIS 7.5 以降では、managedRuntimeLoader、CLRConfigFile、および <add> 要素の startMode 属性を使用して、自動的に起動するようにアプリケーションを構成できます。 これらの属性は、それぞれ、アプリケーションのランタイム読み込みを提供するマネージド DLL の名前、アプリケーションの共通言語ランタイム構成ファイル、およびアプリケーションのスタートアップの種類を構成します。

IIS 7.5 以降の新機能には、<processModel> 要素の identityType 属性の新しい ApplicationPoolIdentity 型もあります。 この新しい ID 型が、アプリケーションの既定のプロセス ID になり、コンテンツ領域のセキュリティを設定して、特定のアプリケーション プールへのアクセスを許可できるようになりました。 これを行うには、"IIS AppPool\DefaultAppPool" のような構文を使用して、アプリケーション プールの名前を使ってセキュリティを設定します。この ID は動的に作成されるため、攻撃対象になるサーバー領域が大幅に減少します。

互換性

段取り

<applicationPools> コレクションは、IIS 7 以降の既定のインストールに含まれています。

操作方法

新しいアプリケーション プールの作成方法

1. 次のようにインターネット インフォメーション サービス (IIS) マネージャーを開きます。

   • Windows Server 2012 または Windows Server 2012 R2 を使用している場合:

     • タスク バーで、[サーバー マネージャー] をクリックし、[ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows 8 または Windows 8.1 を使用している場合:

     • Windows キーを押しながら文字 X を押し、[コントロール パネル] をクリックします。
     • [管理ツール] をクリックし、[インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

   • Windows Server 2008 または Windows Server 2008 R2 を使用している場合:

     • タスク バーで、[スタート] ボタンをクリックし、[管理ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows Vista または Windows 7 を使用している場合:

     • タスク バーで、[スタート]、[コントロール パネル] の順にクリックします。
     • [管理ツール] をダブルクリックし、[インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

2. [接続] ウィンドウでサーバー名を展開し、[アプリケーション プール] をクリックします。

3. [操作] ウィンドウで [アプリケーション プールの追加...] をクリックします。

4. [アプリケーション プールの追加] ダイアログ ボックスで [名前] ボックスにアプリケーション プールの名前を入力し、[.NET Framework バージョン] ドロップダウン リストでサイトまたはアプリケーションが使用する .NET Framework バージョンを選び、[マネージド パイプライン モード] ドロップダウン リストで [統合] または [クラシック] を選択して、[OK]クリックします。
   

既存のサイトまたはアプリケーションのアプリケーション プールの構成方法

1. [接続] ウィンドウで、[サイト] を展開し、アプリケーション プールを追加する先の Web サイトまたはアプリケーションにアクセスします。
2. [操作] ウィンドウの [詳細設定...] をクリックします。
3. [詳細設定] ダイアログ ボックスの [全般] セクションで、[アプリケーション プール] エントリをクリックし、省略記号ボタンをクリックします。
   
4. [アプリケーション プールの選択] ダイアログ ボックスで、[アプリケーション プール] ドロップダウン ボックスからアプリケーション プールを選び、[OK] をクリックして、もう一度 [OK] をクリックします。
   

構成

<applicationPools> コレクションの <add> 要素は ApplicationHost.config ファイルにサーバー レベルで構成できます。

属性

子要素

構成サンプル

次の構成サンプルは、アプリケーション プールの <add> 要素を使用して、Contoso という名前の新しいアプリケーション プールを作成します。 <recycling> 要素は、アプリケーション プールの再開のログを構成し、<periodicRestart> 要素はアプリケーション プールがいつ再開するかを構成し、<processModel> 要素はアプリケーション プール内のワーカー プロセスのシャットダウンと開始の shutdownTimeLimit 属性と startupTimeLimit 属性をそれぞれ 30 秒間に構成します。 これらの制限時間を超えると、IIS がワーカー プロセスを終了します。

<add name="Contoso">
   <recycling logEventOnRecycle="Schedule">
      <periodicRestart>
         <schedule>
            <clear />
            <add value="03:00:00" />
         </schedule>
      </periodicRestart>
   </recycling>
   <processModel identityType="NetworkService" shutdownTimeLimit="00:00:30" startupTimeLimit="00:00:30" />
</add>

サンプル コード

次のコード例は、Contoso という名前のアプリケーション プールを IIS 7 以降のサーバーに追加し、次にアプリケーション プールを毎日午前 3 時にリサイクルするように設定します。

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso']" /commit:apphost

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso'].recycling.periodicRestart.schedule.[value='03:00:00']" /commit:apphost

次の構文も使用できます。

appcmd.exe add apppool /name:"Contoso"

appcmd.exe set config -section:system.applicationHost/applicationPools /+"[name='Contoso'].recycling.periodicRestart.schedule.[value='03:00:00']" /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 applicationPoolsSection = config.GetSection("system.applicationHost/applicationPools");
         ConfigurationElementCollection applicationPoolsCollection = applicationPoolsSection.GetCollection();
         ConfigurationElement addElement = applicationPoolsCollection.CreateElement("add");
         addElement["name"] = @"Contoso";
         ConfigurationElement recyclingElement = addElement.GetChildElement("recycling");
         ConfigurationElement periodicRestartElement = recyclingElement.GetChildElement("periodicRestart");
         ConfigurationElementCollection scheduleCollection = periodicRestartElement.GetCollection("schedule");
         ConfigurationElement addElement1 = scheduleCollection.CreateElement("add");
         addElement1["value"] = TimeSpan.Parse("03:00:00");
         scheduleCollection.Add(addElement1);
         applicationPoolsCollection.Add(addElement);
         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 applicationPoolsSection As ConfigurationSection = config.GetSection("system.applicationHost/applicationPools")
      Dim applicationPoolsCollection As ConfigurationElementCollection = applicationPoolsSection.GetCollection
      Dim addElement As ConfigurationElement = applicationPoolsCollection.CreateElement("add")
      addElement("name") = "Contoso"
      Dim recyclingElement As ConfigurationElement = addElement.GetChildElement("recycling")
      Dim periodicRestartElement As ConfigurationElement = recyclingElement.GetChildElement("periodicRestart")
      Dim scheduleCollection As ConfigurationElementCollection = periodicRestartElement.GetCollection("schedule")
      Dim addElement1 As ConfigurationElement = scheduleCollection.CreateElement("add")
      addElement1("value") = TimeSpan.Parse("03:00:00")
      scheduleCollection.Add(addElement1)
      applicationPoolsCollection.Add(addElement)
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST");
var applicationPoolsCollection = applicationPoolsSection.Collection;

var addElement = applicationPoolsCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "Contoso";
var recyclingElement = addElement.ChildElements.Item("recycling");
var periodicRestartElement = recyclingElement.ChildElements.Item("periodicRestart");
var scheduleCollection = periodicRestartElement.ChildElements.Item("schedule").Collection;
var addElement1 = scheduleCollection.CreateNewElement("add");
addElement1.Properties.Item("value").Value = "03:00:00";
scheduleCollection.AddElement(addElement1);
applicationPoolsCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST")
Set applicationPoolsCollection = applicationPoolsSection.Collection

Set addElement = applicationPoolsCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "Contoso"
Set recyclingElement = addElement.ChildElements.Item("recycling")
Set periodicRestartElement = recyclingElement.ChildElements.Item("periodicRestart")
Set scheduleCollection = periodicRestartElement.ChildElements.Item("schedule").Collection
Set addElement1 = scheduleCollection.CreateNewElement("add")
addElement1.Properties.Item("value").Value = "03:00:00"
scheduleCollection.AddElement(addElement1)
applicationPoolsCollection.AddElement(addElement)

adminManager.CommitChanges()