New-SPAlternateURL

參考

模組:: sharepoint-server

適用於:: SharePoint Server Subscription Edition

為指定的 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 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。

此類型必須是有效的名稱、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 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

共用方式為