Поделиться через

Конфигурация перенаправления <конфигурацииПеренаправление>

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

Элемент <configurationRedirection> позволяет совместно использовать файлы конфигурации из централизованного расположения на нескольких компьютерах сервера IIS 7 в веб-ферме. Это позволяет настроить один сервер IIS 7 в веб-ферме и совместно использовать полученные параметры конфигурации на всех серверах IIS 7 в веб-ферме. Этот элемент также позволяет хранить параметры конфигурации на UNC-сервере, к которому могут получить доступ все компьютеры веб-серверов в веб-ферме.

Изменения в IIS 7.5

В IIS 7.5 добавлены два новых атрибута, которые определяют, будут ли службы IIS использовать уведомления об изменениях или UNC-опрос, чтобы определить, были ли изменены файлы конфигурации. Они перечислены ниже.

  • enableUncPolling:

    • Если задано значение true, СЛУЖБЫ IIS периодически проверка общую папку UNC, чтобы проверить, обновлены ли файлы конфигурации.
    • Если задано значение false, уведомления об изменениях будут по-прежнему использоваться в iis 7.0.

  • pollingPeriod: указывает интервал времени между проверками UNC, которые будут использоваться службами IIS.

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

Версия Примечания
IIS 10.0 Элемент <configurationRedirection> не был изменен в IIS 10.0.
IIS 8,5 Элемент <configurationRedirection> не был изменен в IIS 8.5.
IIS 8,0 Элемент <configurationRedirection> не был изменен в IIS 8.0.
IIS 7,5 Атрибуты enableUncPolling и pollingPeriod были добавлены в IIS 7.5.
IIS 7.0 Элемент <configurationRedirection> появился в IIS 7.0.
IIS 6,0 IIS 6.0 не поддерживает общую конфигурацию.

Настройка

Элемент <configurationRedirection> включен в установку iis 7 по умолчанию.

Инструкции

Экспорт параметров конфигурации и включение общей конфигурации

  1. Откройте диспетчер служб 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.

  2. В области Подключения щелкните подключение к серверу, для которого требуется настроить перенаправление конфигурации.

  3. На панели Главная дважды щелкните общую конфигурацию.
    Снимок экрана: панель

  4. В области Действия щелкните Экспорт конфигурации.
    Снимок экрана: панель

  5. В диалоговом окне Экспорт конфигурации введите путь к каталогу, в который требуется экспортировать файлы конфигурации, в поле Физический путь , введите и подтвердите пароль шифрования, а затем нажмите кнопку ОК.
    Снимок экрана: окно

  6. Когда откроется диалоговое окно Экспорт конфигурации, нажмите кнопку ОК.
    Снимок экрана: диалоговое окно

Включение общей конфигурации

  1. Откройте диспетчер служб 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.

  2. В области Подключения щелкните подключение к серверу, для которого требуется настроить перенаправление конфигурации.

  3. На панели Главная дважды щелкните общую конфигурацию.
    Снимок экрана: панель

  4. В области Общая конфигурация выберите параметр Включить общую конфигурацию .

  5. В поле Физический путь введите путь к общим файлам конфигурации, введите имя учетной записи с разрешениями на доступ к общим файлам конфигурации в поле Имя пользователя , введите пароль учетной записи в поле Пароль , а затем снова введите пароль учетной записи в поле Подтверждение пароля .
    Снимок экрана: окно общей конфигурации.

  6. В области Действия нажмите кнопку Применить.

  7. В поле Ввод пароля ключа шифрования диалогового окна Пароль ключей шифрования введите пароль для ключа шифрования, созданного на шаге 5, и нажмите кнопку ОК.
    Снимок экрана: поле пароля ключа шифрования.

  8. В каждом из диалоговых окон Общая конфигурация нажмите кнопку ОК , чтобы закрыть диалоговые окна.
    Снимок экрана: диалоговое окно общей конфигурации с существующими ключами шифрования I IS.
    Снимок экрана: диалоговое окно общей конфигурации с перезапуском диспетчера I I SS.

    Примечание

    Необходимо закрыть и перезапустить диспетчер IIS, прежде чем он отразит эти изменения конфигурации.

Конфигурация

Элемент <configurationRedirection> настраивается в файле Redirection.config.

Атрибуты

Атрибут Описание
enabled Дополнительный логический атрибут.

Указывает, включено или отключено перенаправление конфигурации на веб-сервере.

Значение по умолчанию — false.
enableUncPolling Дополнительный логический атрибут.

Значение true, если для проверка, были ли обновлены файлы конфигурации, следует использовать UNC-опрос; в противном случае — значение false, если следует использовать уведомления об изменениях. Примечание. Интервал времени между проверками настраивается атрибутом pollingPeriod .

Примечание: Этот атрибут был добавлен в IIS 7.5.

Значение по умолчанию — false.
password Необязательный строковый атрибут.

Указывает пароль, необходимый для проверки подлинности имени пользователя для доступа к расположению для хранения файлов конфигурации. Это строка с учетом регистра.

Примечание: Чтобы избежать сохранения незашифрованных строк паролей в файлах конфигурации, всегда используйте AppCmd.exe или диспетчер IIS для ввода паролей. При использовании этих средств управления строки паролей будут зашифрованы автоматически перед записью в XML-файлы конфигурации. Это обеспечивает лучшую защиту паролей, чем хранение незашифрованных паролей.
path Необязательный строковый атрибут.

Указывает расположение для чтения файлов конфигурации и ключей шифрования. Это может быть сетевой путь или папка на локальном компьютере.

Значение по умолчанию отсутствует.
pollingPeriod Необязательный атрибут timeSpan.

Указывает интервал времени между проверками, который службы IIS будут использовать для проверка, были ли обновлены файлы конфигурации. Примечание. Это применимо только в том случае, enableUncPolling если атрибут имеет значение true.

Примечание: Этот атрибут был добавлен в IIS 7.5.

Значение по умолчанию — 00:03:00 (три минуты).
userName Необязательный строковый атрибут.

Указывает имя пользователя для доступа к расположению для хранения файлов конфигурации.

Значение по умолчанию отсутствует.

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

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

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

В следующем примере кода показано, как настроить IIS 7 для совместного использования файлов конфигурации и ключей шифрования в общем каталоге в сети.

<CONFIGURATION>

   <CONFIGSECTIONS>
      <SECTION name="configurationRedirection" />
   </CONFIGSECTIONS>

   <CONFIGPROTECTEDDATA>
      <PROVIDERS>
         <ADD description="Uses RsaCryptoServiceProvider to encrypt and decrypt" name="IISRsaProvider" type="" keyContainerName="iisConfigurationKey" cspProviderName="" useMachineContainer="true" useOAEP="false" />
      </PROVIDERS>
   </CONFIGPROTECTEDDATA>

   <CONFIGURATIONREDIRECTION enabled="true" path="\\ServerName\ShareName" userName="MyUser" password="[enc:IISRsaProvider:57686f6120447564652c2049495320526f636b73:enc]" />

</CONFIGURATION>

Пример кода

В следующих примерах для доступа к общей папке используются экспортированные файлы конфигурации, к которым предоставлен общий доступ \\ServerName\ShareName, и имя пользователя MyUser с паролем P@ssw0rd.

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.GetRedirectionConfiguration();
         ConfigurationSection redirectionSection = config.GetSection("configurationRedirection");

         redirectionSection.Attributes["enabled"].Value = true;
         redirectionSection.Attributes["path"].Value = @"\\ServerName\ShareName";
         redirectionSection.Attributes["userName"].Value = @"MyUser";
         redirectionSection.Attributes["password"].Value = @"P@ssw0rd";

         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.GetRedirectionConfiguration
      Dim redirectionSection As ConfigurationSection = config.GetSection("configurationRedirection")
      redirectionSection.Attributes("enabled").Value = True
      redirectionSection.Attributes("path").Value = "\\ServerName\ShareName"
      redirectionSection.Attributes("userName").Value = "MyUser"
      redirectionSection.Attributes("password").Value = "P@ssw0rd"
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

try
{
   var config = WScript.CreateObject( "Microsoft.ApplicationHost.WritableAdminManager" );
   config.CommitPath = "MACHINE/REDIRECTION";
   var section = config.GetAdminSection( "configurationRedirection","MACHINE/REDIRECTION" );
   section.Properties.Item( "enabled" ).Value = true;
   section.Properties.Item( "path" ).Value = "\\\\ServerName\\ShareName";
   section.Properties.Item( "userName" ).Value = "MyUser";
   section.Properties.Item( "password" ).Value = "P@ssw0rd";
   config.CommitChanges();
}
catch(e)
{
   WScript.Echo(e.number); 
   WScript.Echo(e.description);
}

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/REDIRECTION"

Set configurationRedirection = adminManager.GetAdminSection( "configurationRedirection", _
"MACHINE/REDIRECTION" )

configurationRedirection.Properties.Item( "enabled" ).Value = True
configurationRedirection.Properties.Item( "path" ).Value = "\\ServerName\ShareName"
configurationRedirection.Properties.Item( "userName" ).Value = "MyUser"
configurationRedirection.Properties.Item( "password" ).Value = "P@ssw0rd"

adminManager.CommitChanges