Addalternatedomain: операция Stsadm (Windows SharePoint Services)
Имя операции: Addalternatedomain
Описание
Добавляет внутренний URL-адрес и сопоставляет его с одной из пяти зон URL веб-приложения или внешнего ресурса.
Данная операция совпадает с параметром интерфейса пользователя Добавление внутренних URL-адресов, который находится на странице "Сопоставления для альтернативного доступа" веб-сайта центра администрирования SharePoint.
Дополнительные сведения см. в разделе Настройка альтернативного сопоставления доступа (Windows SharePoint Services).
Синтаксис
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 |
Допустимое имя, например, "Ресурс1" |
Нет. При этом, имя ресурса уже должно существовать, прежде чем этот параметр можно будет использовать. Новое имя ресурса можно создать при помощи операции Addzoneurl. Примечание Если используется параметр resourcename, параметр url использовать невозможно. . |
Указывает на внешний ресурс, к которому должен быть добавлен внутренний URL-адрес. Этот параметр соответствует параметру пользовательского интерфейса Сопоставление с внешним ресурсом, который находится на странице "Создание сопоставления с внешним ресурсом" веб-сайта центра администрирования SharePoint. |
Примечания
Может быть выполнено отдельное сопоставление зон для каждого веб-приложения.
В Службы Windows SharePoint Services 2.0 внутренний URL-адрес назывался входящим URL-адресом, а общедоступный URL-адрес — исходящим URL-адресом.
Для каждого веб-запроса Windows SharePoint Services 3.0 определяет протокол, заголовок узла и порт запроса и ищет соответствующий внутренний URL-адрес, введенный ранее. При нахождении такого URL-адреса Windows SharePoint Services 3.0 определяет зону, которая будет использоваться для форматирования гиперссылок в ответе. В зоне URL-адресов находится один общедоступный и один или несколько внутренних URL-адресов.
Сопоставления для альтернативного доступа позволяют веб-приложению, получающему запрос на внутренний URL-адрес в одной из пяти зон проверки подлинности, вернуть страницы, содержащие ссылки на общедоступный URL-адрес этой зоны. Веб-приложение можно связать с набором сопоставлений между внутренними и общедоступными URL-адресами. Внутренние адреса относятся к URL-адресу веб-запроса, полученного Windows SharePoint Services 3.0, а общедоступные адреса — к URL-адресу веб-сайта, доступного извне. Общедоступный URL-адрес — это базовый URL-адрес, который используется Windows SharePoint Services 3.0 для возвращаемых страниц. Если внутренний URL-адрес изменен обратным прокси-сервером, он может отличаться от общедоступного URL-адреса.
Несколько внутренних URL-адресов могут быть связаны с одним общедоступным URL-адресом. Наборы сопоставлений могут включать в себя до пяти зон проверки подлинности, однако для каждой зоны может быть назначен только один общедоступный URL-адрес. Наборы сопоставлений соответствуют следующим зонам проверки подлинности:
Default (По умолчанию)
Internet (Интернет)
Intranet (Интрасеть)
Extranet (Экстрасеть)
Custom (Настраиваемая)
Дополнительные сведения о зонах, URL-адресах и логической архитектуре см. в разделе Разработка логической архитектуры (Windows SharePoint Services)
Семейства сайтов с именем узла не могут использовать альтернативные сопоставления доступа. Они автоматически относятся к зоне по умолчанию, и 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/