New-SPAlternateURL

为指定的 Web 应用程序区域或资源创建新的公用 URL 或内部 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>]

说明

此 cmdlet 包含多个参数集。 您可以只使用来自一个参数集的参数,也可以不合并来自不同参数集的参数。 若要详细了解如何使用参数集,请参阅 Cmdlet 参数集

New-SPAlternateUrl cmdlet 可为指定的 Web 应用程序区域或资源创建新的公用 URL 或内部 URL。 如果备用 URL 用于外部资源,请使用 ResourceName 参数。

每个 Web 应用程序都可以与内部 URL 和公用 URL 间的一个映射集相关联。 内部 URL 和公共 URL 都包含完整 URL 的协议和域部分;例如 。 https://www.fabrikam.com 用户键入公用 URL 来访问 SharePoint 网站,该 URL 显示在页面上的链接中。 内部 URL 包含在发送给 SharePoint 网站的 URL 请求中。 在多服务器场中,可将多个内部 URL 与一个公用 URL 相关联(例如,当负载平衡器将对特定 IP 地址的请求传送到负载平衡群集中的各个服务器时)。

每个 Web 应用程序对每个 URL 都支持五个映射集;这五个映射集与五个区域(默认区域、Intranet、Extranet、Internet 和自定义区域)相对应。 当 Web 应用程序收到针对特定区域中的内部 URL 的请求时,返回给用户的页面上的链接具有该区域的公用 URL。

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

示例

------------------示例-----------------------

#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.comhttps://sharepoint.contoso.com 转换为 Internet 区域) 上的 (。

当将反向代理设置为处理公用 URL SSL 终止时,必须配置备用访问映射以处理 URL 转换。

参数

-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

-Internal

使此备用 URL 成为内部 URL。 如果不提供此参数,则该 URL 将为公用 URL。

Type:SwitchParameter
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

-ResourceName

如果备用 URL 用于外部资源,则指定资源名称。 如果未指定值,则值保留为空。

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

-Url

指定用户登录到 Web 应用程序时访问的公用 URL。

类型必须是有效的 URL,格式为 https://server_name.

Type:String
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

-WebApplication

指定要为其创建映射的 Web 应用程序的名称、URL 或 GUID。

键入的值必须为有效名称(格式为 WebApplication-1212)、URL(格式为 https://server_name)或 GUID(格式为 1234-5678-9876-0987)。

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:True
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 关联的那个区域。

键入的值必须为有效区域: 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