New-SPAlternateURL

参考

模块:: sharepoint-server

适用于:: SharePoint Server Subscription Edition

为指定的 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.com https://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 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

-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 Subscription Edition

-ResourceName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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 Subscription Edition

-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 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