初期化ページの追加: <add>

[アーティクル]
03/25/2024

概要

<applicationInitialization> 要素の <add> 要素は、アプリケーションの再起動時に初期化するアプリケーションを指定します。アプリケーションの初期化プロセスを実行するため、IIS は初期化を促すフェイク要求をアプリケーションに送信します。複数の <add> タグを使って、複数のアプリケーションの URL を指定できます。これらのアプリケーションは、要求元には提供されません。顧客には、<applicationInitialization> 要素の remapManagedRequestsTo 属性で指定されているページが提供されます。

互換性

バージョン	メモ
IIS 10.0	`<add>` 要素は、IIS 10.0 では変更されませんでした。
IIS 8.5	`<add>` 要素は、IIS 8.5 では変更されませんでした。
IIS 8.0	`<add>` 要素は IIS 8.0 で導入されました。
IIS 7.5	該当なし
IIS 7.0	該当なし
IIS 6.0	該当なし

段取り

Web サーバーでアプリケーションの初期化をサポートするには、Application Initialization の役割または機能をインストールする必要があります。

Windows Server 2012 または Windows Server 2012 R2

タスクバーで [サーバーマネージャー]をクリックします。
[サーバーマネージャー] で、[管理] メニューをクリックし、[役割と機能の追加] をクリックします。
役割と機能の追加ウィザードで、[次へ] をクリックします。インストールの種類を選択し、[次へ] をクリックします。対象サーバーを選択し、[次へ] をクリックします。
[サーバーの役割] ページで、[Web サーバー (IIS)]、[Web サーバー]、[アプリケーション開発] の順に展開して、[Application Initialization] を選びます。次へをクリックします。
。
[機能の選択] ページで [次へ] をクリックします。
[インストールオプションの確認] ページで、[インストール] をクリックします。
[結果] ページで、 [閉じる]をクリックします。

Windows 8 または Windows 8.1

[スタート] 画面で、ポインターを左下隅まで移動し、[スタート] ボタンを右クリックし、[コントロールパネル] をクリックします。
[コントロールパネル] で [プログラムと機能] をクリックし、[Windows の機能の有効化または無効化] をクリックします。
[インターネットインフォメーションサービス]、[World Wide Web サービス]、[アプリケーション開発機能] の順に展開して、[Application Initialization] を選びます。
OK をクリックします。
閉じるをクリックします。

操作方法

Application Initialization を構成する方法

インターネットインフォメーションサービス (IIS) マネージャーを開きます。
- Windows Server 2012 以降を使用している場合:
  - タスクバーで、[サーバーマネージャー]、[ツール]、[インターネットインフォメーションサービス (IIS) マネージャー] の順にクリックします。
- Windows 8 以降を使用している場合:
  - Windows キーを押しながら文字 X を押し、[コントロールパネル] をクリックします。
  - [管理ツール] をクリックし、[インターネットインフォメーションサービス (IIS) マネージャー] をダブルクリックします。
[接続] ウィンドウで、サーバーを選ぶか、サーバーを展開し、[サイト] を展開して、サイトを選びます。
[ホーム] ウィンドウで、[構成エディター] 機能をダブルクリックします。
サイトを選んだ場合は、[接続元] テキストボックスで [<サイト名> Web.config] を選んでから、[セクション] テキストボックスで [system.webServer/applicationInitialization] を選びます。
サーバーを選んだ場合は、[セクション] テキストボックスで [system.webServer/applicationInitialization] を選びます。
初期化の間に返される静的ファイルの名前を指定するには、remapManagedRequestsTo にファイルの名前を設定します。
マネージドモジュールを読み込まない場合は、skipManagedModules を true に設定します。
アプリケーションが再起動するたびに初期化プロセスが自動的に開始されるように指定するには、doAppInitAfterRestart を true に設定します。
アプリケーションの再起動時に初期化するアプリケーション (1 つまたは複数) を指定するには、[(コレクション)] 行をクリックしてから、省略記号をクリックします。
コレクションエディターで、初期化するアプリケーションを追加するには、[追加] をクリックし、[hostName] をクリックしてから、hostName をホストの名前に設定します。 [initializationPage] をクリックして、アプリケーションの URL に設定します。ダイアログボックスを閉じる
[操作] ウィンドウで [適用] をクリックします。

構成

<applicationInitialization> 要素の <add> 要素は、サーバー、サイト、またはアプリケーションのレベルで構成されます。

属性

属性	説明
`initializationPage`	必須の文字列属性です。アプリケーションの再起動時に初期化するアプリケーションの URL を指定します。既定値は `""` です。
`hostName`	省略可能な文字列属性。 initializationPage 属性で指定されたアプリケーション URL で使われるホスト名。既定値は `""` です。

子要素

なし。

構成サンプル

次のサンプルでは、Application Initialization の構成を示します。

<system.webServer>
   <applicationInitialization
      doAppInitAfterRestart="true"
      skipManagedModules="true"
      remapManagedRequestsTo="filename.htm"/>
      <add initializationPage="/default.aspx" hostName="myhost"/>
   </applicationInitialization>
</system.webServer>

サンプルコード

次の例では、サイトの <applicationInitialization> を構成しています。

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/applicationInitialization /remapManagedRequestsTo:"HelloJoe.htm" /skipManagedModules:"True" /doAppInitAfterRestart:"True"  /commit:apphost

appcmd.exe set config "Default Web Site" -section:system.webServer/applicationInitialization /+"[initializationPage='JoesSite.htm',hostName='JoesHost']" /commit:apphost

Note

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

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 applicationInitializationSection = config.GetSection("system.webServer/applicationInitialization", "Default Web Site");
            applicationInitializationSection["remapManagedRequestsTo"] = @"HelloJoe.htm";
            applicationInitializationSection["skipManagedModules"] = true;
            applicationInitializationSection["doAppInitAfterRestart"] = true;
            
            ConfigurationElementCollection applicationInitializationCollection = applicationInitializationSection.GetCollection();
            
            ConfigurationElement addElement = applicationInitializationCollection.CreateElement("add");
            addElement["initializationPage"] = @"JoesSite.htm";
            addElement["hostName"] = @"JoesHost";
            applicationInitializationCollection.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 applicationInitializationSection As ConfigurationSection = config.GetSection("system.webServer/applicationInitialization", "Default Web Site")
         applicationInitializationSection("remapManagedRequestsTo") = "HelloJoe.htm"
         applicationInitializationSection("skipManagedModules") = true
         applicationInitializationSection("doAppInitAfterRestart") = true
         Dim applicationInitializationCollection As ConfigurationElementCollection = applicationInitializationSection.GetCollection
         Dim addElement As ConfigurationElement = applicationInitializationCollection.CreateElement("add")
         addElement("initializationPage") = "JoesSite.htm"
         addElement("hostName") = "JoesHost"
         applicationInitializationCollection.Add(addElement)
         serverManager.CommitChanges
     End Sub
 End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var applicationInitializationSection = adminManager.GetAdminSection("system.webServer/applicationInitialization", "MACHINE/WEBROOT/APPHOST/Default Web Site");
applicationInitializationSection.Properties.Item("remapManagedRequestsTo").Value = "HelloJoe.htm";
applicationInitializationSection.Properties.Item("skipManagedModules").Value = true;
applicationInitializationSection.Properties.Item("doAppInitAfterRestart").Value = true;

var applicationInitializationCollection = applicationInitializationSection.Collection;

var addElement = applicationInitializationCollection.CreateNewElement("add");
addElement.Properties.Item("initializationPage").Value = "JoesSite.htm";
addElement.Properties.Item("hostName").Value = "JoesHost";
applicationInitializationCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set applicationInitializationSection = adminManager.GetAdminSection("system.webServer/applicationInitialization", "MACHINE/WEBROOT/APPHOST/Default Web Site")
applicationInitializationSection.Properties.Item("remapManagedRequestsTo").Value = "HelloJoe.htm"
applicationInitializationSection.Properties.Item("skipManagedModules").Value = true
applicationInitializationSection.Properties.Item("doAppInitAfterRestart").Value = true

Set applicationInitializationCollection = applicationInitializationSection.Collection

Set addElement = applicationInitializationCollection.CreateNewElement("add")
addElement.Properties.Item("initializationPage").Value = "JoesSite.htm"
addElement.Properties.Item("hostName").Value = "JoesHost"
applicationInitializationCollection.AddElement(addElement)

adminManager.CommitChanges()

PowerShell

Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "remapManagedRequestsTo" -value "HelloJoe.htm"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "skipManagedModules" -value "True"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "doAppInitAfterRestart" -value "True"

Add-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "." -value @{initializationPage='JoesSite.htm';hostName='JoesHost'}

初期化ページの追加: <add>

概要

互換性

段取り

Windows Server 2012 または Windows Server 2012 R2

Windows 8 または Windows 8.1

操作方法

Application Initialization を構成する方法

構成

属性

子要素

構成サンプル

サンプルコード

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

PowerShell

フィードバック

フィードバック

その他のリソース

初期化ページの追加: <add>

概要

互換性

段取り

Windows Server 2012 または Windows Server 2012 R2

Windows 8 または Windows 8.1

操作方法

Application Initialization を構成する方法

構成

属性

子要素

構成サンプル

サンプル コード

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

PowerShell

フィードバック

フィードバック

その他のリソース

サンプルコード