New-SPAlternateURL

模块:: SharePointServer module

为指定的 Web 应用程序区域或资源创建新的公用 URL 或内部 URL。

语法

WebApplication

New-SPAlternateURL
    [-Url] <String>
    -WebApplication <SPWebApplicationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Internal]
    [-WhatIf]
    [-Zone <SPUrlZone>]
    [<CommonParameters>]

ResourceName

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

适用：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

参数属性

类型:	SPAssignmentCollection
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

适用：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

执行命令前，看到确认提示。有关详细信息，请键入以下命令：get-help about_commonparameters

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Internal

适用：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceName

适用：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ResourceName

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Url

适用：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WebApplication

适用：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:	SPWebApplicationPipeBind
默认值:	None
支持通配符:	False
不显示:	False

参数集

WebApplication

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

适用：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Zone

适用：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定五个区域中与备用 URL 关联的那个区域。

键入的值必须为有效区域： Default 、 Intranet 、 Internet 、 Extranet 或 Custom 。

参数属性

类型:	SPUrlZone
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

反馈

此页面是否有帮助？