Set-SPAlternateURL

参考

模块:: sharepoint-server

适用于:: SharePoint Server Subscription Edition

配置指定的备用 URL。

语法

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

说明

cmdlet Set-SPAlternateUrl 更改由 Identity 参数指定的备用 URL 的 URL 或区域。此 cmdlet 只能用于更改内部 URL 的区域，不能用于更改公共 URL 的区域。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息，请参阅 SharePoint Server cmdlet。

示例

------------------示例 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"

此示例将指定 Web 应用程序的备用 URL 的区域从 Extranet 更改为 Intranet。

参数

-AssignmentCollection

管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 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

-Identity

指定要更改的备用 URL 的 URL 或 GUID。

键入的值必须是有效的 URL（格式为 https://server_name/WebApplication/site），或者是有效的 GUID（格式为 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 Subscription Edition

-Url

指定新的备用 URL。

Type:	String
Position:	Named
Default value:	None
Required:	False
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