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 以降の既定のインストールに含まれています。
操作方法
サーバーの既定のアプリケーション設定を構成する方法
次のようにインターネット インフォメーション サービス (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) マネージャー] をダブルクリックします。
[接続] ウィンドウでサーバー名を展開し、[サイト] ノードをクリックします。
[Web サイトの既定値] ダイアログ ボックスで、Web サイトの既定のアプリケーション設定を指定し、[OK] をクリックします。
構成
属性
属性 | 説明 |
---|---|
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()