Http Redirects <httpRedirect>

Статья
07/19/2023

Элемент <httpRedirect> настраивает параметры служб IIS 7, которые перенаправляют клиентские запросы в новое расположение.

Существует несколько причин, по которым может потребоваться перенаправить клиенты в новое расположение. Например, если ваша компания выполняет миграцию на новый веб-сайт, вы можете перенаправить все запросы со старого веб-сайта на новый веб-сайт. Аналогичным образом, если вы развернули новое приложение на веб-сервере, вы можете перенаправить все запросы к пространству имен URL-адресов старого приложения (например, http://www.contoso.com/app_v1.0/) в новое расположение приложений (например, http://www.contoso.com/app_v2.0/).

В простейшей конфигурации необходимо задать только атрибуты<httpRedirect> enabled и destination элемента, чтобы перенаправлять клиенты в новое расположение. Однако дополнительные элементы, такие как атрибуты exactDestination и httpResponseStatus , позволяют настроить взаимодействие с конечным пользователем перенаправления, указав соответственно, будет ли IIS 7 возвращать целевой URL-адрес точно так, как введено, и какой код HTTP-ответа будет возвращен веб-клиенту.

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

Версия	Примечания
IIS 10.0	В элемент IIS 10.0 добавлено дополнительное `<httpRedirect>` состояние HTTP-ответа.
IIS 8,5	Элемент `<httpRedirect>` не был изменен в IIS 8.5.
IIS 8,0	Элемент `<httpRedirect>` не был изменен в IIS 8.0.
IIS 7,5	Элемент `<httpRedirect>` не был изменен в IIS 7.5.
IIS 7.0	Элемент `<httpRedirect>` появился в IIS 7.0.
IIS 6,0	Элемент `<httpRedirect>` заменяет свойство метабазы HttpRedirect IIS 6.0.

Установка

Перенаправление HTTP недоступно при установке iis 7 и более поздних версий по умолчанию. Чтобы установить его, выполните следующие действия.

Windows Server 2012 или Windows Server 2012 R2

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

Windows 8 или Windows 8.1

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

Windows Server 2008 или Windows Server 2008 R2

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

Windows Vista или Windows 7

На панели задач нажмите кнопку Пуск, а затем панель управления.
В панель управления выберите Программы и компоненты, а затем — Включить или отключить компоненты Windows.
Разверните узел Службы IIS, затем Веб-службы, а затем Общие функции HTTP.
Выберите Http Redirection (Перенаправление HTTP) и нажмите кнопку ОК.

Инструкции

Отсутствует пользовательский интерфейс для добавления подстановочных перенаправлений HTTP для IIS 7. Примеры программного добавления <add> элементов в <httpRedirect> элемент см. в разделе Примеры кода этого документа.

Добавление правила перенаправления HTTP на веб-сайт или приложение

Откройте диспетчер служб 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.
В области Подключения разверните имя сервера, узел Сайты, а затем перейдите к веб-сайту или приложению, для которого требуется настроить пользовательские страницы ошибок.
На панели Главная дважды щелкните HTTP-перенаправление.
В области Перенаправление HTTP проверка поле для перенаправления запросов и введите ЦЕЛЕВОй URL-адрес.
При необходимости можно указать любой из следующих параметров:
- Настройте назначение перенаправления так, чтобы он был точным, как указано.
- Настройте назначение перенаправления так, чтобы он ограничивался корневой папкой URL-адреса назначения, а не вложенными папками.
- Настройте код состояния HTTP, который может быть одним из следующих параметров:
  - 301 Постоянный
  - 302 — объект найден
  - 307 Временный
  - 308 Постоянное перенаправление
  Примечание
  
  СЛУЖБЫ IIS 7 будут соответственно возвращать следующие фактические состояния HTTP-ответа для каждого из указанных выше параметров:
  - HTTP/1.1 301 перемещен без возможности восстановления
  - Перенаправление HTTP/1.1 302
  - Перенаправление HTTP/1.1 307
  - HTTP 1.1 308 перенаправляется без возможности восстановления
Завершив все описанные выше изменения, нажмите кнопку Применить в области Задачи .

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

Атрибуты

Атрибут Описание

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

Указывает, следует ли добавить целевое значение в начало имени файла, содержащего запрос для перенаправления. Например, если параметру childOnly присвоено значение true, а целевому значению задано http://marketing.contoso.com/значение , запрос будет http://contoso.com/default.htm перенаправлен в http://marketing.contoso.com/default.htm.

Значение по умолчанию — false.

destination Необязательный строковый атрибут.

Указывает URL-адрес или виртуальный путь для перенаправления клиента.

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

Указывает, включено ли перенаправление (true) или отключено (false).

Значение по умолчанию — false.

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

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

Значение по умолчанию — false.

httpResponseStatus

Необязательный атрибут перечисления.

Указывает тип перенаправления.

Атрибут httpResponseStatus может быть одним из следующих возможных значений. Значение по умолчанию — Found.

Значение	Описание
`Found`	Возвращает код состояния 302, который указывает клиенту отправить новый запрос к расположению, указанному в атрибуте назначения. Числовое значение равно `302`.
`Permanent`	Возвращает код состояния 301, который сообщает клиенту о том, что расположение запрошенного ресурса постоянно изменилось. Числовое значение равно `301`.
`Temporary`	Возвращает код состояния 307, который предотвращает потерю данных клиентом, когда браузер отправляет HTTP-запрос POST. Числовое значение равно `307`.
`PermRedirect`	Возвращает код состояния 308, который сообщает клиенту о том, что расположение запрошенного ресурса постоянно изменилось. Числовое значение равно `308`.

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

Элемент	Описание
`add`	Необязательный элемент. Добавляет правило перенаправления с подстановочными знаками в коллекцию правил перенаправления.
`clear`	Необязательный элемент. Удаляет все ссылки на правила перенаправления с подстановочными знаками из коллекции правил перенаправления.
`remove`	Необязательный элемент. Удаляет ссылку на правило перенаправления с подстановочными знаками из коллекции правил перенаправления.

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

Следующий элемент по умолчанию <httpRedirect> настраивается в корневом файле ApplicationHost.config в IIS 7 при установке службы роли перенаправления HTTP. Этот раздел конфигурации наследует параметры конфигурации по умолчанию, если не используется <clear> элемент .

<system.webServer>
   <httpRedirect enabled="false" />
</system.webServer>

Следующий пример конфигурации включает перенаправление и настраивает целевой URL-адрес, на который перенаправляются клиенты.

<system.webServer>
   <httpRedirect enabled="true" destination="http://www.contoso.com/" />
</system.webServer>

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

Примечание

Этот пример полезен, если вы удалили все приложения на основе ASP с веб-сайта и хотите, чтобы клиентские запросы для старых приложений перенаправлялись в корень веб-сайта, а не получали ответ HTTP 404 Not Found .

<configuration>
   <system.webServer>
      <httpRedirect enabled="true" exactDestination="true" httpResponseStatus="Found">
         <add wildcard="*.php" destination="/default.htm" />
      </httpRedirect>
   </system.webServer>
</configuration>

Пример кода

В следующих примерах кода веб-сайт по умолчанию настраивает перенаправление всех запросов на http://www.contoso.com с помощью кода состояния HTTP 302.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/httpRedirect /enabled:"True"
appcmd.exe set config "Default Web Site" -section:system.webServer/httpRedirect /destination:"http://www.contoso.com"
appcmd.exe set config "Default Web Site" -section:system.webServer/httpRedirect /exactDestination:"False"
appcmd.exe set config "Default Web Site" -section:system.webServer/httpRedirect /httpResponseStatus:"Found"

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.GetWebConfiguration("Default Web Site");

         ConfigurationSection httpRedirectSection = config.GetSection("system.webServer/httpRedirect");
         httpRedirectSection["enabled"] = true;
         httpRedirectSection["destination"] = @"http://www.contoso.com";
         httpRedirectSection["exactDestination"] = false;
         httpRedirectSection["httpResponseStatus"] = @"Found";

         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.GetWebConfiguration("Default Web Site")

      Dim httpRedirectSection As ConfigurationSection = config.GetSection("system.webServer/httpRedirect")
      httpRedirectSection("enabled") = True
      httpRedirectSection("destination") = "http://www.contoso.com"
      httpRedirectSection("exactDestination") = False
      httpRedirectSection("httpResponseStatus") = "Found"

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

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

var httpRedirectSection = adminManager.GetAdminSection("system.webServer/httpRedirect", "MACHINE/WEBROOT/APPHOST/Default Web Site");
httpRedirectSection.Properties.Item("enabled").Value = true;
httpRedirectSection.Properties.Item("destination").Value = "http://www.contoso.com";
httpRedirectSection.Properties.Item("exactDestination").Value = false;
httpRedirectSection.Properties.Item("httpResponseStatus").Value = "Found";

adminManager.CommitChanges();

VBScript

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

Set httpRedirectSection = adminManager.GetAdminSection("system.webServer/httpRedirect", "MACHINE/WEBROOT/APPHOST/Default Web Site")
httpRedirectSection.Properties.Item("enabled").Value = True
httpRedirectSection.Properties.Item("destination").Value = "http://www.contoso.com"
httpRedirectSection.Properties.Item("exactDestination").Value = False
httpRedirectSection.Properties.Item("httpResponseStatus").Value = "Found"

adminManager.CommitChanges()

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

Примечание

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/httpRedirect /enabled:"True" /exactDestination:"True" /httpResponseStatus:"Found"

appcmd.exe set config "Default Web Site" -section:system.webServer/httpRedirect /+"[wildcard='*.asp',destination='/default.htm']"

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.GetWebConfiguration("Default Web Site");

         ConfigurationSection httpRedirectSection = config.GetSection("system.webServer/httpRedirect");
         httpRedirectSection["enabled"] = true;
         httpRedirectSection["exactDestination"] = true;
         httpRedirectSection["httpResponseStatus"] = @"Found";

         ConfigurationElementCollection httpRedirectCollection = httpRedirectSection.GetCollection();
         ConfigurationElement addElement = httpRedirectCollection.CreateElement("add");
         addElement["wildcard"] = @"*.asp";
         addElement["destination"] = @"/default.htm";
         httpRedirectCollection.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.GetWebConfiguration("Default Web Site")

      Dim httpRedirectSection As ConfigurationSection = config.GetSection("system.webServer/httpRedirect")
      httpRedirectSection("enabled") = True
      httpRedirectSection("exactDestination") = True
      httpRedirectSection("httpResponseStatus") = "Found"

      Dim httpRedirectCollection As ConfigurationElementCollection = httpRedirectSection.GetCollection
      Dim addElement As ConfigurationElement = httpRedirectCollection.CreateElement("add")
      addElement("wildcard") = "*.asp"
      addElement("destination") = "/default.htm"
      httpRedirectCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

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

var httpRedirectSection = adminManager.GetAdminSection("system.webServer/httpRedirect", "MACHINE/WEBROOT/APPHOST/Default Web Site");
httpRedirectSection.Properties.Item("enabled").Value = true;
httpRedirectSection.Properties.Item("exactDestination").Value = true;
httpRedirectSection.Properties.Item("httpResponseStatus").Value = "Found";

var httpRedirectCollection = httpRedirectSection.Collection;
var addElement = httpRedirectCollection.CreateNewElement("add");
addElement.Properties.Item("wildcard").Value = "*.asp";
addElement.Properties.Item("destination").Value = "/default.htm";
httpRedirectCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

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

Set httpRedirectSection = adminManager.GetAdminSection("system.webServer/httpRedirect", "MACHINE/WEBROOT/APPHOST/Default Web Site")
httpRedirectSection.Properties.Item("enabled").Value = True
httpRedirectSection.Properties.Item("exactDestination").Value = True
httpRedirectSection.Properties.Item("httpResponseStatus").Value = "Found"

Set httpRedirectCollection = httpRedirectSection.Collection
Set addElement = httpRedirectCollection.CreateNewElement("add")
addElement.Properties.Item("wildcard").Value = "*.asp"
addElement.Properties.Item("destination").Value = "/default.htm"
httpRedirectCollection.AddElement(addElement)

adminManager.CommitChanges()

Http Redirects <httpRedirect>

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

Установка

Windows Server 2012 или Windows Server 2012 R2

Windows 8 или Windows 8.1

Windows Server 2008 или Windows Server 2008 R2

Windows Vista или Windows 7

Инструкции

Добавление правила перенаправления HTTP на веб-сайт или приложение

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

Атрибуты

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

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

Пример кода

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Обратная связь

Обратная связь

Дополнительные ресурсы