アプリケーションのデフォルト<applicationDefaults>
- 概要
- 互換性
- セットアップ
- 方法
- 構成
- サンプル コード
※本ページに挿入されている画像をクリックすると、画像全体が別ウィンドウで表示されます。
概要
<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()