Добавление страницы <инициализации>

Статья
07/19/2023

Общие сведения

Элемент <add> в элементе <applicationInitialization> указывает приложение, которое будет инициализироваться при перезапуске приложения. Чтобы выполнить процесс инициализации приложения, IIS отправляет в приложение поддельный запрос на инициализацию. С помощью нескольких тегов можно указать несколько <add> URL-адресов приложений. Эти приложения не предоставляются инициатору запроса. Страница, указанная атрибутом remapManagedRequestsTo в элементе <applicationInitialization> , будет обслуживаться клиенту.

Совместимость

Версия	Примечания
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	Н/Д

Настройка

Для поддержки инициализации приложений на веб-сервере необходимо установить роль или компонент инициализации приложений.

Windows Server 2012 или Windows Server 2012 R2

На панели задач щелкните Диспетчер сервера.
В диспетчер сервера откройте меню Управление и выберите пункт Добавить роли и компоненты.
В мастере добавления ролей и компонентов нажмите кнопку Далее. Выберите тип установки и нажмите кнопку Далее. Выберите целевой сервер и нажмите кнопку Далее.
На странице Роли сервера разверните узел Веб-сервер (IIS),веб-сервер, узел Разработка приложений, а затем выберите Инициализация приложений. Щелкните Далее.
.
На странице Выбор компонентов нажмите кнопку Далее.
На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
На странице Результаты нажмите кнопку Закрыть.

Windows 8 или Windows 8.1

На начальном экране переместите указатель в левый нижний угол, щелкните правой кнопкой мыши кнопку Пуск и выберите панель управления.
В панель управления выберите Программы и компоненты, а затем — Включить или отключить компоненты Windows.
Разверните узлы Службы IIS, Веб-службы, Функции разработки приложений, а затем выберите Пункт Инициализация приложений.
Нажмите кнопку ОК.
Щелкните Закрыть.

Инструкции

Настройка инициализации приложений

Откройте диспетчер служб IIS:
- Если вы используете Windows Server 2012 или более поздней версии:
  - На панели задач щелкните диспетчер сервера, выберите Сервис, а затем диспетчер служб IIS.
- Если вы используете Windows 8 или более поздней версии:
  - Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
  - Щелкните Администрирование, а затем дважды щелкните Диспетчер служб IIS.
В области Подключения выберите сервер или разверните сервер, разверните узел Сайты, а затем выберите сайт.
На панели Главная дважды щелкните компонент Редактор конфигурации .
Если вы выбрали сайт, выберите <имя> сайта Web.config в текстовом поле От , а затем выберите system.webServer/applicationInitialization в текстовом поле Раздел .
Если вы выбрали сервер, выберите system.webServer/applicationInitialization в текстовом поле Раздел .
Чтобы указать имя статического файла, возвращаемого во время инициализации, присвойте remapManagedRequestsTo имя файла.
Если вы не хотите загружать управляемые модули, задайте для параметра skipManagedModulesзначение true.
Чтобы указать, что процесс инициализации инициируется автоматически при перезапуске приложения, установите для параметра doAppInitAfterRestartзначение true.
Чтобы указать приложение или приложения, которые будут инициализироваться при перезапуске приложения, щелкните строку (Коллекция) и нажмите кнопку с многоточием.
Чтобы добавить приложение для инициализации, в редакторе коллекций нажмите кнопку Добавить, выберите hostName, а затем задайте hostName в качестве имени узла. Щелкните initializationPage и задайте URL-адрес приложения. Закройте диалоговое окно.
Щелкните Применить в области Действия.

Параметр Configuration

Элемент <add><applicationInitialization> элемента настраивается на уровне сервера, сайта или приложения.

Атрибуты

Атрибут	Описание
`initializationPage`	Обязательный строковый атрибут. Указывает URL-адрес приложения, инициализированного при перезапуске приложения. Значение по умолчанию — `""`.
`hostName`	Необязательный строковый атрибут. Имя узла, используемое с URL-адресом приложения, указанным в атрибуте initializationPage. Значение по умолчанию — `""`.

Дочерние элементы

Отсутствует.

Образец конфигурации

В следующем примере показана конфигурация инициализации приложения.

<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

Примечание

При использовании AppCmd.exe для настройки этих параметров необходимо обязательно задать для параметра фиксации значение 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 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'}