Set-SPAlternateUrl
适用于： SharePoint Foundation 2010, SharePoint Server 2010
上一次修改主题： 2015-03-09
配置指定的备用 URL。
Syntax
Set-SPAlternateUrl [-Identity] <SPAlternateUrlPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Url <String>] [-WhatIf [<SwitchParameter>]] [-Zone <Default | Intranet | Internet | Custom | Extranet>]
详细说明
Set-SPAlternateUrl cmdlet 更改 Identity 参数指定的备用 URL 的 URL 或区域。此 cmdlet 只能用于更改内部 URL 的区域，不能用于更改公用 URL 的区域。
有关 Windows PowerShell for SharePoint 产品的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Identity |
必需 |
Microsoft.SharePoint.PowerShell.SPAlternateUrlPipeBind |
指定要更改的备用 URL 的 URL 或 GUID。 该类型必须是有效的 URL（格式为 http://server_name/WebApplication/site），或者是有效的 GUID（格式为 12345678-90ab-cdef-1234-567890bcdefgh）。 |
Url |
必需 |
System.String |
指定新的备用 URL。 |
Zone |
必需 |
System.String |
将所提供的备用 URL 设置为这五个区域中的一个区域。 该类型必须是下列值中的任何一个：Default、Intranet、Internet、Extranet 或 Custom。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 .gif "注意") Note
在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
|
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters |
输入类型
返回类型
Example
------------------示例 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 https://www.contoso.com 的 URL 和区域。
------------------示例 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"
此示例将指定 Web 应用程序的备用 URL 的区域从 Extranet 更改为 Intranet。