Addzoneurl : Stsadm 操作 (Windows SharePoint Services)

  • [アーティクル]

操作名 : Addzoneurl

説明

パブリック URL を構成し、パブリック URL を Web アプリケーションまたは外部リソースの 5 つの URL 領域のいずれかにマップします。

このプロパティは、SharePoint サーバーの全体管理 Web サイトの [領域のパブリック URL の編集] ページにある [パブリック 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 です。このパラメータは、対象としている Web アプリケーションを Stsadm が決定できるように、Web アプリケーションに割り当てられる既存の代替アクセス マッピング (AAM) の URL である必要があります。URL は、対象の Web アプリケーションに関連付けられている任意の領域からのパブリック URL か内部 URL のどちらかです。

urlzone

次のいずれかの値です。

  • 既定

  • イントラネット

  • インターネット

  • エクストラネット

  • ユーザー設定

必須

パブリック URL が関連付けられている 5 つの領域の 1 つです。

zonemappedurl

有効な URL (https://www.contoso.com など)

必須

追加するパブリック URL です。このパブリック URL は、Web サーバーからリバース プロキシ サーバーまたはクライアントへ移動する Web ページまたは電子メール メッセージ上のハイパーリンクで使用されるベース URL として使用されます。この URL は、エンド ユーザーがアクセスできるものです。この手順を実行することにより、URL がサーバーからクライアントに返されると、エンド ユーザーに正しい URL が表示されます。

resourcename

有効な名前 ("Resource1" など)

省略可能。ただし、resourcename パラメータを使用する場合、url パラメータは使用できません。

その既定領域にパブリック URL がある新しいリソース名を addzoneurl 操作を使用して作成する必要があります。リソース名が作成されると、既存のリソース名を使用して、パブリック URL を追加領域に追加したり、既存のパブリック URL を更新したりできます。

このパラメータは、SharePoint サーバーの全体管理 Web サイトの [外部リソースのマッピングの作成] ページにある [外部リソースのマッピング] ユーザー インターフェイス設定と同じです。

備考

Windows SharePoint Services 2.0 では、内部 URL は受信 URL と呼ばれ、パブリック URL は送信 URL と呼ばれていました。

各 Web 要求については、Windows SharePoint Services 3.0 により、プロトコル、ホスト ヘッダー、および要求のポートが決定され、以前に入力された対応する内部 URL が検索されます。対応する内部 URL が見つかると、Windows SharePoint Services 3.0 により、応答でのハイパーリンクの書式を設定するために使用される領域が決定されます。URL 領域には、パブリック URL が 1 つと内部 URL が 1 つまたは複数含まれます。

代替アクセス マッピングによって、5 つの認証領域のいずれかで内部 URL の要求を受信した Web アプリケーションは、その領域のパブリック URL へのリンクを含んだページを返すことができます。内部 URL とパブリック URL とのマッピングのコレクションに、Web アプリケーションを関連付けることができます。

内部とは Windows SharePoint Services 3.0 が受信したときの Web 要求の URL を指します。パブリックとは外部からアクセスできる Web サイトの URL を指します。パブリック URL は、Windows SharePoint Services 3.0 が返すページで使用するベース URL です。

内部 URL は、リバース プロキシ デバイスによって変更されている場合、パブリック URL と異なることがあります。

複数の内部 URL を単一のパブリック URL に関連付けることができます。マッピング コレクションには最高 5 つの認証領域を含められますが、それぞれの領域にはパブリック URL を 1 つしか割り当てられません。マッピング コレクションは次の認証領域に対応しています。

  • 既定

  • インターネット

  • イントラネット

  • エクストラネット

  • ユーザー設定

既定領域には、常にパブリック URL が含まれている必要があります。

領域、URL、および論理アーキテクチャについては、「論理アーキテクチャを設計する (Windows SharePoint Services)」を参照してください。

ホスト名付きサイト コレクションでは、代替アクセス マッピングを使用できません。ホスト名付きサイト コレクションは自動的に既定領域に存在すると見なされ、要求の URL はエンド ユーザーとサーバーとの間で変更できません。

例

リバース プロキシ サーバーまたはロード バランサが、ユーザーからの要求を 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