IIS アプリケーションの既定値 <applicationDefaults>

概要

<sites><applicationDefaults> 要素は、サーバー上のすべてのアプリの既定のアプリ設定を指定します。

Note

特定のアプリケーションに対して <applicationDefaults> セクションと <application> セクションの両方で同じ属性または子要素が構成されている場合は、<application> セクションの構成がそのアプリケーションに対して使用されます。

互換性

バージョン メモ
IIS 10.0 <applicationDefaults> 要素は IIS 10.0 では変更されませんでした。
IIS 8.5 <applicationDefaults> 要素は IIS 8.5 では変更されませんでした。
IIS 8.0 <applicationDefaults> 要素は IIS 8.0 では変更されませんでした。
IIS 7.5 <applicationDefaults> 要素は IIS 7.5 では変更されませんでした。
IIS 7.0 <sites> 要素の <applicationDefaults> 要素が IIS 7.0 で導入されました。
IIS 6.0 <applicationDefaults> 要素は、IIS 6.0 メタベースの W3SVC レベルでアプリケーション オプションを設定するのと似ています。

段取り

<sites> 要素の <applicationDefaults> 要素は、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. サーバーの [サイト] ペインで、[操作] ウィンドウの [Web サイトの既定値の設定...] をクリックします。。
    [操作] ウィンドウの [Web サイトの既定値の設定] タブが表示された [サイト] ウィンドウを示すスクリーンショット。

  4. [Web サイトの既定値] ダイアログ ボックスで、Web サイトの既定のアプリケーション設定を指定し、[OK] をクリックします。
    [アプリケーション プール] が強調表示されている [Web サイトの既定値] ダイアログ ボックスのスクリーンショット。

構成

属性

属性 説明
applicationPool 省略可能な文字列属性。

サーバー上のすべてのアプリケーションが割り当てられる既定のアプリケーション プールを指定します。
enabledProtocols 省略可能な文字列属性。

サーバー上のすべてのアプリケーションとの通信に使用するプロトコルを指定します。
path 省略可能な文字列属性。

サーバー上のすべてのアプリケーションの既定の仮想パスを指定します。

子要素

なし。

構成サンプル

次の構成サンプルは、すべての Web サイトの既定のアプリケーション プールを "DefaultAppPool" に設定します。

<system.applicationHost>
   <sites>
     <applicationDefaults applicationPool="DefaultAppPool" />
   </sites>
</system.applicationHost>

サンプル コード

次のコード サンプルは、すべての Web サイトの既定のアプリケーション プールを "DefaultAppPool" に設定します。

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /applicationDefaults.applicationPool:"DefaultAppPool" /commit:apphost

Note

AppCmd.exe を使用してこれらの設定を構成するときは、commit パラメーターを必ず apphost に設定する必要があります。 これで、ApplicationHost.config ファイルの適切な場所セクションに構成設定がコミットされます。

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 sitesSection = config.GetSection("system.applicationHost/sites");

         ConfigurationElement applicationDefaultsElement = sitesSection.GetChildElement("applicationDefaults");
         applicationDefaultsElement["applicationPool"] = @"DefaultAppPool";

         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 sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")

      Dim applicationDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("applicationDefaults")
      applicationDefaultsElement("applicationPool") = "DefaultAppPool"

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");

var applicationDefaultsElement = sitesSection.ChildElements.Item("applicationDefaults");
applicationDefaultsElement.Properties.Item("applicationPool").Value = "DefaultAppPool";

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")

Set applicationDefaultsElement = sitesSection.ChildElements.Item("applicationDefaults")
applicationDefaultsElement.Properties.Item("applicationPool").Value = "DefaultAppPool"

adminManager.CommitChanges()