Addzoneurl:Stsadm 作業 (Windows SharePoint Services)
作業名稱:Addzoneurl
描述
設定公用 URL,並將其對應到 Web 應用程式的五個 URL 區域之一或外部資源。
此屬性相當於 [公用 URL] 使用者介面設定,位於 SharePoint 管理中心網站的 [編輯公用區域 URL] 頁面上。
如需詳細資訊,請參閱<設定備用存取對應 (Windows SharePoint Services)>。
語法
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。
備用存取對應可讓在五個驗證區域之一接收內部 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 關聯。對應集合最多可包含五個驗證區域,但每個區域都只能有一個公用 URL。對應集合會對應到下列驗證區域:
預設值
網際網路
內部網路
外部網路
自訂
預設區域必須一律包含公用 URL。
如需區域、URL 和邏輯架構的其他資訊,請參閱<設計邏輯架構 (Windows SharePoint Services)>。
具有主機名稱的網站集合無法使用備用存取對應。具有主機名稱的網站集合會自動視為位於預設區域,而且一般使用者與伺服器之間的要求 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