New-SPAlternateURL

為指定的 Web 應用程式區或資源建立新的公用或內部 URL。

Syntax

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

Description

此 Cmdlet 包含一個以上的參數集。 您可能只使用一個參數集中的參數,但不可以結合不同參數集的參數。 如需如何使用參數集的詳細資訊,請參閱 Cmdlet 參數集

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。

如需適用於 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 網際網路區域) 上的 (。

設定反向 Proxy 處理公用 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。

此類型必須是有效的名稱、URL,格式為 WebApplication-1212、https://server_name,或格式為 1234-5678-9876-0987 的 GUID。

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