New-SPAlternateURL

Создает общедоступный или внутренний 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>]

Описание

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

The New-SPAlternateUrl cmdlet creates a new public or internal URL for the specified Web application zone or resource. Use the ResourceName parameter if the alternate URL is for an external resource.

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

Each Web application supports five collections of mappings per URL; the five collections correspond to five zones (default, intranet, extranet, Internet, and custom). When the Web application receives a request for an internal URL in a particular zone, links on the pages returned to the user have the public URL for that zone.

Сведения о разрешениях и актуальную информацию о 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

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ResourceName

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

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

-Url

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

The type must be a valid URL, in the form https://server_name.

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

-WebApplication

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

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

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition