New-SPAlternateUrl

發行項
03/07/2017

適用版本： SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間： 2015-03-09

為指定的 Web 應用程式區或資源建立新的公用或內部 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 係供外部資源使用，請使用 ResourceName 參數。

每一個 Web 應用程式皆可以與內部及公用 URL 之間的一組對應集合建立關聯。內部與公用 URL 都會包含完整 URL 的通訊協定與網域部分，例如 https://www.fabrikam.com。使用者若要連入 SharePoint 網站，必須輸入公用 URL，而此 URL 即是頁面連結中所顯示的 URL。內部 URL 包含在傳送至 SharePoint 網站的 URL 要求中。在多伺服器陣列中，可以有多個內部 URL 與單一公用 URL 建立關聯，例如，負載平衡器可以將特定 IP 位址的要求傳遞至負載平衡叢集中的各伺服器。

每一個 Web 應用程式在每一個 URL 上都支援五個對應集合；這五個集合會對應至五個區域 (預設、內部網路、外部網路、網際網路及自訂)。當 Web 應用程式收到特定區域中內部 URL 的要求時，傳回給使用者的頁面上的連結會有該區域的公用 URL。

Parameters

參數	必要	類型	描述
Url	必要	System.String	指定使用者用於登入 Web 應用程式的公用 URL。此類型必須是格式為 http://server_name 的有效 URL。
WebApplication	必要	Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind	指定要建立對應之 Web 應用程式的名稱、URL 或 GUID。此類型必須是有效的名稱、URL，格式為 WebApplication-1212、http://server_name，或格式為 1234-5678-9876-0987 的 GUID。
ResourceName	必要	System.String	若備用 URL 係供外部資源使用，請指定資源名稱。若不指定任何值，該值會保持空白。
AssignmentCollection	選用	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。注意使用 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 區域中)。

設定反向 Proxy 處理公用 URL SSL 的終止時，必須設定備用存取對應處理 URL 轉譯。

共用方式為