New-SPAlternateUrl

项目
10/14/2016

适用于： SharePoint Foundation 2010, SharePoint Server 2010

上一次修改主题： 2015-03-09

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

Syntax

New-SPAlternateUrl [-Url] <String> -WebApplication <SPWebApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Internal <SwitchParameter>] [-WhatIf [<SwitchParameter>]] [-Zone <Default | Intranet | Internet | Custom | Extranet>]

New-SPAlternateUrl [-Url] <String> -ResourceName <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Internal <SwitchParameter>] [-WhatIf [<SwitchParameter>]] [-Zone <Default | Intranet | Internet | Custom | Extranet>]

详细说明

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。

Parameters

参数	必需	类型	说明
Url	必需	System.String	指定用户登录到 Web 应用程序时访问的公用 URL。该类型必须是格式为 http://server_name 的有效 URL。
WebApplication	必需	Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind	指定要为其创建映射的 Web 应用程序的名称、URL 或 GUID。类型必须为有效名称（格式为 WebApplication-1212）、URL（格式为 http://server_name）或 GUID（格式为 1234-5678-9876-0987）。
ResourceName	必需	System.String	如果备用 URL 用于外部资源，则指定资源名称。如果未指定值，则值保留为空。
AssignmentCollection	可选	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 Note 在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
Confirm	可选	System.Management.Automation.SwitchParameter	在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters
Internal	可选	System.Management.Automation.SwitchParameter	使此备用 URL 成为内部 URL。如果不提供此参数，则该 URL 将为公用 URL。
WhatIf	可选	System.Management.Automation.SwitchParameter	显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters
Zone	可选	System.String	指定五个区域中与备用 URL 关联的那个区域。键入的值必须为有效区域：Default、Intranet、Internet、Extranet 或 Custom。

输入类型

返回类型

Example

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

#create the public URL
New-SPAlternateURL https://www.contoso.com -Zone "Internet"

#create the internal URL
New-SPAlternateURL http://sharepoint.contoso.com -Zone "Internet" -internal

此示例将对 https://www.contoso.com 的传入请求转换为对 http://sharepoint.contoso.com（在 Internet 区域上）的传入请求。

通过