このトピックでは、Windows SharePoint Services (WSS) アダプターのトラブルシューティングについて説明します。
取り付け
Windows SharePoint Services (WSS) アダプターを使用する場合、次の 2 つのオプションがあります。
選択肢 | 説明 |
---|---|
クライアント OM を [はい] に設定して使用する | 推奨されます。 [はい] に設定すると、SharePoint Services クライアント側オブジェクト モデル (CSOM) が使用されます。 アダプターは、BizTalk Server のインストール時にインストールされます。 追加のインストール手順はありません。 手記: BizTalk Server のインストールでは、 SharePoint クライアント オブジェクト モデル再頒布可能パッケージも自動的にインストールされます。 |
クライアント OM を [いいえ] に設定して使用します。 |
非推奨。 SharePoint Services サービス側オブジェクト モデル (SSOM) を使用します。 Web サービスは SharePoint Services コンピューターにインストールされます。SharePoint Services コンピューターは、BizTalk Server と同じコンピューターまたは別のコンピューターにインストールできます。 Web サービスをインストールするには、SharePoint Services コンピューターで BizTalk Server のインストールを実行し、 Windows SharePoint Services アダプターを確認します。 特定のインストール手順については、「 付録 B: Microsoft SharePoint アダプター をインストールする」を参照してください。 |
クライアント OM を [はい ] に設定することをお勧めします。 [はい] に設定すると、Web サービスは SharePoint コンピューターにインストールされません。 Web サービス オプションを使用する場合は、BizTalk Server で [クライアント OM の使用 ] を [いいえ ] に設定する必要があります。
IIS
BTSharePointAdapterWS.asmx Web サービス
SharePoint コンピューターに Windows SharePoint Services アダプターをインストールすると、SHAREPoint コンピューターの IIS に BTSharePointAdapterWS.asmx Web サービスが作成されます。 通常、BizTalk Server と SharePoint は異なるコンピューターにインストールされます。 SharePoint がインストールされている場合、コンテンツ SQL データベースは、SharePoint コンピューターまたはリモート SQL Server に対してローカルにすることができます。
アプリケーション プールでドメイン アカウントを使用する
BizTalk と SharePoint が異なるコンピューター上にある場合、BTSharePointAdapterWS.asmx Web サービスを実行する IIS アプリケーション プールでドメイン アカウントを使用する必要があります。 BizTalk Server、BizTalk データベース、SharePoint Services、SQL Server SharePoint データベースがすべて同じコンピューターにインストールされている場合は、ローカル アカウントを使用できます。
Double-Hop シナリオ
3 台のコンピューター (BizTalk Server、SharePoint Services、SQL Server) がある場合、Kerberos 認証を必要とするダブルホップ シナリオがあります。 BizTalk コンピューター上の SharePoint アダプターは、SharePoint コンピューター上の BTSharePointAdapterWS.asmx Web サービスに対して POST 要求を実行します。 その後、SharePoint コンピューターは SQL Server コンピューター上のデータベースに対してクエリを実行します。
BizTalk アダプターからのこの POST 要求は正常に完了する必要があります。 認証エラーが疑われる場合は、IIS ログを確認します。 既定では、IIS ログは c:\inetpub\logs\LogFiles\W3SVCx にあります。 POST 要求には、200 (成功) 状態コードが表示されます。 失敗した状態コード (401.2 など) が返され、その後に 401.1 が続き、さらに 4xx エラーが続くと、認証が失敗する可能性があります。
Kerberos 認証を使用する場合は、サービス プリンシパル名 (SPN) が必要であり、委任を有効にする必要があります。
Kerberos 認証を有効にする
ダブルホップ シナリオでは、Kerberos 認証と委任の有効化が必要です。 手順を次に示します。
IIS/SharePoint サーバーで ネゴシエート を有効にします。 詳細については、「 Windows 認証
<windowsAuthentication>
」を参照してください。サービス プリンシパル名 (SPN) は、IIS/SharePoint コンピューターで SQL Server サービスとアプリケーション プールを実行するドメイン アカウントに必要です。 サービス プリンシパル名の構成の詳細については、「 サービス プリンシパル名 (SPN)」を参照してください。
Windows 8、Windows Server 2008 SP2、Windows Server 2008 R2、および Windows Server 2012: SetSPN
Von Bedeutung
SetSPN にはドメイン管理者権限が必要であり、ドメイン内の任意のコンピューターから実行できます。
ドメイン アカウントに登録されているすべての SPN の一覧を返すには:
setspn.exe -l Domain\UserAccount
SPN を作成します。
IIS/SharePoint コンピューターの FQDN の SPN を作成します。
setspn.exe -s http/IISSharePointComputerName.___domain.com ___domain\IISApplicationPoolDomainAccount
IIS/SharePoint コンピューターの NETBIOS 名の SPN を作成します。
setspn.exe -s http/IISSharePointComputerNamedomain\IISApplicationPoolDomainAccount
IIS/SharePoint コンピューターで使用される SQL Server コンピューターの FQDN の SPN を作成します。
setspn.exe -s mssqlsvc/SQLComputerName.___domain.com ___domain\SQLServerServiceDomainAccount
IIS/SharePoint コンピューターで使用される SQL Server コンピューターの FQDN と TCP ポートの SPN を作成します。
setspn.exe -s mssqlsvc/SQLComputerName.___domain.com:1433 ___domain\SQLServerServiceDomainAccount
IIS/SharePoint コンピューターで使用される SQL Server コンピューターの NETBIOS 名の SPN を作成します。
setspn.exe -s mssqlsvc/SQLComputerNamedomain\SQLServerServiceDomainAccount
IIS/SharePoint コンピューターで使用される SQL Server コンピューターの NETBIOS 名:TCP ポートの SPN を作成します。
setspn.exe -s mssqlsvc/SQLComputerName:1433 ___domain\SQLServerServiceDomainAccount
ドメイン コントローラーで、 Active Directory ユーザーとコンピューター に移動し、次の操作を行います。
次のコンピューターに対して、任意のサービスへの委任のために、このコンピューターを信頼してください。
SharePoint/IIS サーバー
SharePoint で使用される SQL Server
アカウントを委任に信頼する にチェックを入れ、アカウントは機密であり、委任できません のチェックを外すよう、次のドメイン アカウントで設定します。
SQL Server サービス ドメイン アカウント
IIS アプリケーション プール ドメイン アカウント
その他のトラブルシューティングについては、「Windows SharePoint Services アダプターのトラブルシューティング」を参照してください。
こちらもご覧ください
SharePoint Services 受信場所の構成SharePoint Services 送信ポートCSOM の構成: SharePoint Services アダプター