Addzoneurl:Stsadm 作業 (Office SharePoint Server)
描述
設定公用 URL,並將其對應到 Web 應用程式或外部資源的 5 個 URL 區域之一。
此屬性相當於 SharePoint 管理中心網站之 [編輯公用區域 URL] 頁面上的 [公用 URL] 使用者介面設定。
如需詳細資訊,請參閱<設定備用存取對應>。
語法
stsadm -o addzoneurl
-url <URL 名稱>
-urlzone {Default | Internet | Intranet | Extranet | Custom}
-zonemappedurl <http://public.url>
-resourcename <非 Web 應用程式資源名稱>
參數
參數名稱 |
值 |
必要? |
描述 |
url |
有效的 URL,例如 http://server_name 或 http://server_name:1234 |
否。但若使用 url 參數,即無法使用 resourcename 參數。 |
Web 應用程式的 URL。此參數應為現有的備用存取對應 (AAM) URL,並指派給 Web 應用程式,以便 Stsadm 判斷您的目標 Web 應用程式。此 URL 可以是和目標 Web 應用程式相關聯之任何區域的公用 URL 或內部 URL。 |
urlzone |
下列任一值:
|
是 |
與公用 URL 關聯的五個區域之一。 |
zonemappedurl |
有效的 URL,例如 https://www.contoso.com |
是 |
您要新增的公用 URL。其用為基底 URL,係用於網頁超連結中或從網頁伺服器送至回復 proxy 伺服器或用戶端的電子郵件訊息中。此 URL 是一般使用者可連絡者。此步驟可確保當 URL 從伺服器傳回用戶端時,一般使用者會看到正確的 URL。 |
resourcename |
有效的名稱,例如 "Resource1" |
否。但若使用 resourcename 參數,即無法使用 url 參數。 |
需要使用 addzoneurl 作業建立在預設區域中有公用 URL 的新資源名稱。資源名稱一旦建立後,即可使用現有的資源名稱,將公用 URL 新增至其他區域,或更新現有的公用 URL。 此參數相當於 SharePoint 管理中心網站之 [建立外部資源對應] 頁面上的 [外部資源對應] 使用者介面設定。 |
備註
在 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 應用程式與對應集合的關聯性。
「內部」** 表示 Microsoft Office SharePoint Server 2007 接收到的 Web 要求之 URL。「公用」** 表示可從外部存取的網站 URL。公用 URL 則為 Office SharePoint Server 2007 在傳回頁面內使用的基底 URL。
如果內部 URL 已由回復 proxy 裝置進行修改,即與公用 URL 不同。
多個內部 URL 可與單一公用 URL 關聯。對應集合最多可包含五個驗證區域,但每個區域都只能有一個公用 URL。對應集合會對應到下列驗證區域:
預設值
網際網路
內部網路
外部網路
自訂
預設區域必須一律包含公用 URL。
如需區域、URL 的其他資訊以及檢視每個區域的公司部署案例,請參閱<邏輯架構模型:公司部署>。
具有主機名稱的網站集合無法使用備用存取對應。具有主機名稱的網站集合會自動視為位於預設區域,而且一般使用者與伺服器之間的要求 URL 絕不能加以修改。
範例
若反向 Proxy 伺服器或負載平衡器收到使用者要求 https://www.contoso.com,並將其以 http://sharepoint.courses.contoso.com:1234 的形式轉寄到執行 Windows SharePoint Services 3.0 的伺服器,則管理員會將 SharePoint Web 應用程式的 URL 設定如下:
內部 URL:http://sharepoint.courses.contoso.com:1234
公用 URL:https://www.contoso.com
此例中,https://sharepoint:1234 已是指定給 Web 應用程式的 AAM URL,而且已使用網際網路區域。
若要設定 URL 區域的公用 URL,請使用下列語法:
stsadm -o addzoneurl -url https://sharepoint:1234 -urlzone Internet -zonemappedurl https://www.contoso.com
若要確認公用 URL 的變更,請使用下列語法:
stsadm -o enumalternatedomains -url https://sharepoint:1234
另請參閱
概念
Enumalternatedomains
Deletezoneurl
Addalternatedomain
Enumzoneurls