Добавление перенаправлений с подстановочными знаками <HTTP>

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

Элемент <add><httpRedirect> элемента добавляет правило перенаправления с подстановочными знаками в коллекцию правил перенаправления. Правила с подстановочными знаками позволяют добавлять правила перенаправления для групп содержимого. Например, если вы удалили все страницы *.asp после переноса приложения на страницы .NET, использующие расширения имен файлов *.aspx, можно добавить правило перенаправления с подстановочными знаками, которое перенаправляет все запросы *.asp для старого приложения на основе ASP на домашнюю страницу веб-сайта.

Примечание

При добавлении правил перенаправления с подстановочными знаками необходимо удалить значение назначения по умолчанию в <httpRedirect> разделе, чтобы правила с подстановочными знаками работали.

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

Версия	Примечания
IIS 10.0	Элемент <add> не был изменен в IIS 10.0.
IIS 8,5	Элемент <add> не был изменен в IIS 8.5.
IIS 8,0	Элемент <add> не был изменен в IIS 8.0.
IIS 7,5	Элемент <add> не был изменен в IIS 7.5.
IIS 7.0	Элемент <add> элемента появился <httpRedirect> в IIS 7.0.
IIS 6,0	Н/Д

Настройка

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

Windows Server 2012 или Windows Server 2012 R2

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

Windows 8 или Windows 8.1

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

Windows Server 2008 или Windows Server 2008 R2

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

Windows Vista или Windows 7

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

Инструкции

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

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

Атрибуты

Атрибут	Описание
destination	Обязательный строковый атрибут. Указывает расположение, в которое перенаправляются запросы, соответствующие соответствующему значению подстановочного знака.
wildcard	Обязательный строковый атрибут. Задает уникальное значение подстановочного знака, с которым сравниваются запросы. Затем запрос перенаправляется в указанное место назначения, если запрос соответствует значению подстановочного знака.

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

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

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

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

Примечание

Этот пример полезен, если вы удалили все приложения на основе 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>

Пример кода

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

Примечание

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

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()