Addalternatedomain: операция stsadm (Office SharePoint Server)
Имя операции: Addalternatedomain
Описание
Добавляет внутренний URL-адрес и сопоставляет его с одной из пяти зон URL веб-приложения или внешнего ресурса.
Данная операция совпадает с параметром интерфейса пользователя Добавление внутренних URL-адресов, который находится на странице "Сопоставления для альтернативного доступа" веб-сайта центра администрирования SharePoint.
Дополнительные сведения см. в разделе Настройка сопоставлений альтернативного доступа.
Синтаксис
stsadm -o addalternatedomain
-url <URL-имя>
-incomingurl <http://внутренний.url>
-urlzone {Default | Internet | Intranet | Extranet | Custom}
-resourcename <имя ресурса вне веб-приложения>
Параметры
Имя параметра |
Значение |
Обязательный? |
Описание |
url |
Допустимый URL-адрес, например, http://имя_сервера или http://имя_сервера:1234 |
Нет, но если используется параметр url, параметр resourcename использовать невозможно. |
URL-адрес веб-приложения. В качестве этого параметра должен использоваться существующий URL-адрес сопоставления для альтернативного доступа, присвоенный веб-приложению. В этом случае команда Stsadm может определить, какое веб-приложение имеется в виду. Таким URL-адресом может быть общедоступный URL-адрес или внутренний URL-адрес из любой зоны, связанной с целевым веб-приложением. |
incomingurl |
Допустимый URL-адрес, например, "http://sharepoint.courses.contoso.com:1234/" |
Да |
Внутренний URL-адрес, который необходимо добавить. Данный параметр должен включать в себя только схему протокола, имя узла и номер порта; никаких других частей URL-адрес содержать не должен. С одной зоной URL можно сопоставить несколько внутренних URL-адресов. |
urlzone |
Одно из следующих значений:
|
Да |
Одна из пяти зон, с которой связан внутренний URL-адрес. |
resourcename |
Допустимое имя, например, "Resource1" |
Нет. Однако до использования этого параметра имя ресурса уже должно существовать. Новое имя ресурса можно создать при помощи операции Addzoneurl. Примечание Если используется параметр resourcename, параметр url использовать невозможно. . |
Указывает на внешний ресурс, к которому должен быть добавлен внутренний URL-адрес. Этот параметр соответствует параметру пользовательского интерфейса Сопоставление с внешним ресурсом, который находится на странице "Создание сопоставления с внешним ресурсом" веб-сайта центра администрирования SharePoint. |
Примечания
Может быть выполнено отдельное сопоставление зон для каждого веб-приложения.
В службах Службы Windows SharePoint Services 2.0 внутренний URL-адрес назывался входящим, а общедоступный URL-адрес считался исходящим.
Для каждого веб-запроса Windows SharePoint Services 3.0 определяет протокол, заголовок узла и порт запроса и ищет соответствующий внутренний URL-адрес, введенный ранее. При нахождении такого URL-адреса Windows SharePoint Services 3.0 определяет зону, которая будет использоваться для форматирования гиперссылок в ответе. В зоне URL-адресов находится один общедоступный и один или несколько внутренних URL-адресов.
Сопоставления для альтернативного доступа позволяют веб-приложению, получающему запрос на внутренний URL-адрес в одной из пяти зон проверки подлинности, вернуть страницы, содержащие ссылки на общедоступный URL-адрес этой зоны. Веб-приложение можно связать с набором сопоставлений между внутренними и общедоступными URL-адресами. Внутренние адреса относятся к URL-адресу веб-запроса, полученного Microsoft Office SharePoint Server 2007, а общедоступные адреса — к URL-адресу веб-сайта, доступного извне. Общедоступный URL-адрес — это базовый URL-адрес, который используется Office SharePoint Server 2007 для возвращаемых страниц. Если внутренний URL-адрес изменен обратным прокси-сервером, он может отличаться от общедоступного URL-адреса.
Несколько внутренних URL-адресов могут быть связаны с одним общедоступным URL-адресом. Наборы сопоставлений могут включать в себя до пяти зон проверки подлинности, однако для каждой зоны может быть назначен только один общедоступный URL-адрес. Наборы сопоставлений соответствуют следующим зонам проверки подлинности:
По умолчанию
Интернет
Интрасеть
Экстрасеть
Настраиваемая
Дополнительные сведения о зонах, URL-адресах, а также сценарии корпоративного развертывания для каждой зоны см. в разделе Модель логической архитектуры: корпоративное развертывание.
Семейства сайтов с именем сайта не могут использовать альтернативные сопоставления доступа. Они автоматически относятся к зоне по умолчанию, и URL-адрес запроса между пользователем и сервером не может быть изменен.
Примеры
Если обратный прокси-сервер или балансировщик нагрузки получают запрос от пользователя в виде https://technet.microsoft.com/ru-ru/library/cc706993.aspx и пересылают его на сервер со службами Windows SharePoint Services 3.0 в виде адреса http://sharepoint.courses.contoso.com:1234/, то администратор создаст следующие URL-адреса для веб-приложения SharePoint:
Внутренний URL-адрес: http://sharepoint.courses.contoso.com:1234/
Общедоступный URL-адрес: https://technet.microsoft.com/ru-ru/library/cc706993.aspx
В данном примере https://sharepoint:1234/ — это URL-адрес альтернативного сопоставления доступа, который присвоен веб-приложению; используется зона Интернета.
Чтобы настроить внутренний URL-адрес, используйте следующий синтаксис:
stsadm -o addalternatedomain -url https://sharepoint:1234/ -urlzone Internet -incomingurl http://sharepoint.courses.contoso.com:1234/
Чтобы сопоставить общедоступный URL-адрес с зоной URL, воспользуйтесь следующим синтаксисом:
stsadm -o addzoneurl -url https://sharepoint:1234/ -urlzone Internet -zonemappedurl https://technet.microsoft.com/ru-ru/library/cc706993.aspx
Примечание
Для зоны URL может существовать только один общедоступный URL-адрес: этот адрес используется для веб-страниц или электронных сообщений, поступающих на обратный прокси-сервер или клиент с веб-сервера.
Чтобы подтвердить изменения, внесенные во внутренний URL-адрес, используйте следующий синтаксис:
stsadm -o enumalternatedomains -url http://sharepoint.courses.contoso.com:1234/