Поделиться через


Set-SPAlternateURL

Настраивает заданный альтернативный URL-адрес.

Синтаксис

Set-SPAlternateURL
   [-Identity] <SPAlternateUrlPipeBind>
   [-Url <String>]
   [-Zone <SPUrlZone>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Описание

Командлет Set-SPAlternateUrl изменяет URL-адрес или зону альтернативного URL-адреса, указанного параметром Identity. Этот командлет можно использовать для изменения только зоны внутренних URL-адресов и не может использоваться для изменения зоны общедоступных URL-адресов.

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

Примеры

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

Set-SPAlternateURL -Identity https://www.contoso.com -Zone "Internet"

В этом примере изменяется зона альтернативного URL-адреса https://www.contoso.com.

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

Set-SPAlternateURL -Identity https://www.contoso.com -Url https://sharepoint.contoso.com -Zone "Default"

В этом примере изменяется URL-адрес и зона альтернативного URL-адреса https://www.contoso.com.

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

Get-SPAlternateURL https://www.contoso.com | Set-SPAlternateURL -Zone "Internet"

В этом примере изменяется зона альтернативного URL-адреса https://www.contoso.com.

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

Get-SPWebApplication |%{ Get-SPAlternateURL -WebApplication $_ -Zone "Extranet" } | Set-SPAlternateURL -Zone "Intranet"

В этом примере зона альтернативного URL-адреса для указанного веб-приложения изменяется с Extranet на Intranet.

Параметры

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Задает URL-адрес или идентификатор GUID альтернативного URL-адреса, который необходимо изменить.

The type must be a valid URL, in the form https://server_name/WebApplication/site, or a valid GUID, in the form 12345678-90ab-cdef-1234-567890bcdefgh.

Type:SPAlternateUrlPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Url

Задает новый альтернативный URL-адрес.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Zone

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

Типом должно быть одно из следующих значений: 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019