New-SPAlternateURL

Ссылка

Модуль:: sharepoint-server

Применяется к:: SharePoint Server Subscription Edition

Создает общедоступный или внутренний URL-адрес для указанной зоны или ресурса веб-приложения.

Синтаксис

New-SPAlternateURL
   [-Url] <String>
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Internal]
   [-WhatIf]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]

New-SPAlternateURL
   [-Url] <String>
   -ResourceName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Internal]
   [-WhatIf]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров; использование параметров из разных наборов не допускается. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

Командлет New-SPAlternateUrl создает общедоступный или внутренний URL-адрес для указанной зоны или ресурса веб-приложения. Если другой URL-адрес определяет внешний ресурс, используйте параметр ResourceName.

Каждое веб-приложение может быть связано с набором сопоставлений между внутренними и общедоступными URL-адресами. Как внутренние, так и общедоступные URL-адреса состоят из протокола и доменной части полного URL-адреса; например, https://www.fabrikam.com. Пользователи вводят общедоступный URL-адрес, чтобы перейти на сайт SharePoint, и этот адрес отображается в ссылках на страницах. Внутренние URL-адреса находятся в URL-запросах, которые отправляются на сайт SharePoint. В фермах, состоящих из нескольких серверов, с одним общедоступным URL-адресом может быть связано несколько внутренних (например, когда служба балансировки загрузки пересылает запросы определенных IP-адресов на различные серверы в кластере с балансировкой загрузки).

Каждое веб-приложение поддерживает пять наборов сопоставлений для одного URL-адреса; пять наборов соответствуют пяти зонам (зона по умолчанию, интрасеть, экстрасеть, Интернет и настраиваемая зона). Если веб-приложение получает запрос на внутренний URL-адрес в определенной зоне, ссылки на странице, возвращаемой пользователю, будут содержать общедоступный URL-адрес для этой зоны.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

------------------ПРИМЕР-----------------------

#create the public URL
New-SPAlternateURL https://www.contoso.com -Zone "Internet"

#create the internal URL
New-SPAlternateURL https://sharepoint.contoso.com -Zone "Internet" -internal

В этом примере входящие запросы для https://www.contoso.com преобразуется в https://sharepoint.contoso.com (в зоне Интернета).

При настройке обратного прокси для обработки завершения SSL для общедоступных URL-адресов альтернативные сопоставления доступа необходимо настроить для преобразования URL-адресов.

Параметры

-AssignmentCollection

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Confirm

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Internal

Делает альтернативный URL-адрес внутренним URL-адресом. Если этот параметр опущен, URL-адрес считается общедоступным.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ResourceName

Указывает имя ресурса, если альтернативный URL-адрес предназначен для внешнего ресурса. Если значение не указано, оно будет оставлено пустым.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Url

Указывает общедоступный URL-адрес, используемый для входа в веб-приложение.

Тип должен быть допустимым URL-адресом в форме https://server_name.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WebApplication

Указывает имя, URL-адрес или идентификатор GUID веб-приложения, для которого создается сопоставление.

Тип должен быть допустимым именем, URL-адресом в формате WebApplication-1212 или https://server_nameGUID в форме 1234-5678-9876-0987.

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Zone

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

Тип значения — допустимая зона: Default (по умолчанию), Intranet (интрасеть), Internet (Интернет), Extranet (экстрасеть) или Custom (настраиваемая).

Type:	SPUrlZone
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

Бөлісу құралы: