アプリケーションのデフォルト<applicationDefaults>

[アーティクル]
08/25/2009

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

※本ページに挿入されている画像をクリックすると、画像全体が別ウィンドウで表示されます。

概要

<sites> 要素の <applicationDefaults> 要素では、サーバー上のすべてのアプリケーションの既定のアプリケーション設定が指定されます。

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

互換性

	IIS 7.0	IIS 6.0
注意	`<sites>` の `<applicationDefaults>` は IIS 7.0 で新たに導入された要素です。	`<applicationDefaults>` 要素は、IIS 6.0 メタベースにおける W3SVC レベルでのアプリケーションオプションの設定と似ています。

セットアップ

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

方法

サーバーの既定のアプリケーション設定を構成する方法

タスクバーで [スタート] ボタンをクリックし、[管理ツール] をポイントして [インターネットインフォメーションサービス (IIS) マネージャー] をクリックします。
[接続] ウィンドウで、当該サーバー名を展開し、[サイト] ノードをクリックします。
サーバーの [サイト] ウィンドウで、[操作] ウィンドウにある [Web サイトの既定値の設定] をクリックします。
[Web サイトの既定値] ダイアログボックスで、すべての Web サイトのアプリケーションの既定の設定を指定して [OK] をクリックします。

構成

属性

属性	説明
`applicationPool`	オプションの string 属性。サーバー上のすべてのアプリケーションを割り当てる既定のアプリケーションプールを指定します。
`enabledProtocols`	オプションの string 属性。サーバー上のすべてのアプリケーションとの通信に使用するプロトコルを指定します。
`path`	オプションの string 属性。サーバー上のすべてのアプリケーションの既定の仮想パスを指定します。

子要素

なし。

構成サンプル

次の構成サンプルでは、すべての 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

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()