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

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set, and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet parameter sets.

The New-SPAlternateUrl cmdlet creates a new public or internal URL for the specified Web application zone or resource. Use the ResourceName parameter if the alternate URL is for an external resource.

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

Each Web application supports five collections of mappings per URL; the five collections correspond to five zones (default, intranet, extranet, Internet, and custom). When the Web application receives a request for an internal URL in a particular zone, links on the pages returned to the user have the public URL for that zone.

如需適用於 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

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ResourceName

若備用 URL 係供外部資源使用,請指定資源名稱。 若不指定任何值,該值會保持空白。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Url

指定使用者用於登入 Web 應用程式的公用 URL。

此類型必須是格式為 https://server_name 的有效 URL。

Type:String
Position:1
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition