Share via


Addalternatedomain:Stsadm 作業 (Windows SharePoint Services)

作業名稱:Addalternatedomain

描述

新增內部 URL,並將其對應到 Web 應用程式的五個 URL 區域之一或外部資源。

此作業相當於 [新增內部 URL] 使用者介面設定,位於 SharePoint 管理中心網站的 [備用存取對應] 頁面上。

如需詳細資訊,請參閱<設定備用存取對應 (Windows SharePoint Services)>。

語法

stsadm -o addalternatedomain

-url <URL 名稱>

-incomingurl <http://internal.url>

-urlzone {Default | Internet | Intranet | Extranet | Custom}

-resourcename <非 Web 應用程式資源名稱>

參數

參數名稱

必要?

描述

url

有效的 URL,例如 http://server_name 或 http://server_name:1234

否。但是,如果使用 url 參數,將無法使用 resourcename 參數。

Web 應用程式的 URL。此參數應為現有的 AAM URL,並會指派給 Web 應用程式,以便 Stsadm 能夠判斷您的目標 Web 應用程式。此 URL 可以是和目標 Web 應用程式相關聯之任何區域的公用 URL 或內部 URL。

incomingurl

有效的 URL,如 "http://sharepoint.courses.contoso.com:1234"

您要新增的內部 URL。

此參數應該限制為 URL 的通訊協定配置、主機名稱及連接埠號碼部分,不應該包含 URL 的任何其他部分。您可以將多個內部 URL 對應到同一個 URL 區域。

urlzone

下列任一值:

  • 預設值

  • 內部網路

  • 網際網路

  • 外部網路

  • 自訂

與內部 URL 關聯的五個區域之一。

resourcename

有效的名稱,例如 "Resource1"

否。但必須先有資源名稱存在,才可使用此參數。您可以使用 Addzoneurl 作業建立新的資源名稱。

注意

如果使用 resourcename 參數,將無法使用 url 參數。

.

指定應該要新增內部 URL 的外部資源。

此參數相當於 [外部資源對應] 使用者介面設定,位於 SharePoint 管理中心網站的 [建立外部資源對應] 頁面。

備註

可以執行每個 Web 應用程式的不同區域對應。

過去在 Windows SharePoint Services 2.0 中,內部 URL 參照稱為傳入 URL,而公用 URL 則稱為傳出 URL。

Windows SharePoint Services 3.0 會為每一項 Web 要求決定通訊協定、主機標頭及要求連接埠,以及尋找之前輸入的相符內部 URL。若找到相符的內部 URL,Windows SharePoint Services 3.0 即會決定將用以格式化回應超連結的區域。URL 區域包含一個公用 URL 及一或多個內部 URL。

備用存取對應可讓在 5 個驗證區域之一接收內部 URL 要求的 Web 應用程式,傳回包含該區域公用 URL 連結的頁面。您可以在內部與公用 URL 之間,建立 Web 應用程式與對應集合的關聯性。「內部」表示 Windows SharePoint Services 3.0 接收到的 Web 要求 URL。「公用」表示可從外部存取的網站 URL。公用 URL 則為 Windows SharePoint Services 3.0 在傳回頁面內所使用的基底 URL。如果內部 URL 已由回復 Proxy 裝置進行修改,即與公用 URL 不同。

多個內部 URL 可與單一公用 URL 相關聯。對應集合最多可包含 5 個驗證區域,但每個區域都只能有一個單一公用 URL。對應集合會對應到下列驗證區域:

  • 預設值

  • 網際網路

  • 內部網路

  • 外部網路

  • 自訂

如需區域、URL 和邏輯架構的其他資訊,請參閱<設計邏輯架構 (Windows SharePoint Services)>。

具有主機名稱的網站集合無法使用備用存取對應。具有主機名稱的網站集合會自動視為位於預設區域,而且一般使用者與伺服器之間的要求 URL 絕不能加以修改。

範例

如果反向 Proxy 伺服器或負載平衡器收到使用者要求,顯示為 https://www.contoso.com,將其轉寄到執行 Windows SharePoint Services 3.0 的伺服器,顯示為 http://sharepoint.courses.contoso.com:1234,則管理員會為 SharePoint Web 應用程式設定下列 URL:

內部 URL:http://sharepoint.courses.contoso.com:1234

公用 URL:https://www.contoso.com

此例中,https://sharepoint:1234 已是指定給 Web 應用程式的 AAM URL,而且已使用網際網路區域。

若要設定內部 URL,請使用下列語法:

stsadm -o addalternatedomain -url https://sharepoint:1234 -urlzone Internet -incomingurl http://sharepoint.courses.contoso.com:1234

若要將公用 URL 對應至 URL 區域,請使用下列語法:

stsadm -o addzoneurl -url https://sharepoint:1234 -urlzone Internet -zonemappedurl https://www.contoso.com

注意

每個 URL 區域僅能有一個公用 URL。此 URL 會用於網頁,或從網頁伺服器到回復 Proxy 伺服器或用戶端的外寄電子郵件中。

若要確認對內部 URL 的變更,請使用下列語法:

stsadm -o enumalternatedomains -url http://sharepoint.courses.contoso.com:1234

另請參閱

概念

Addzoneurl
Deletealternatedomain
Enumalternatedomains