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 |