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