SharePoint Services アダプターのトラブルシューティング
このトピックでは、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 コンピューターにインストールされます。これは、BizTalk Serverまたは別のコンピューターと同じコンピューター上に置くことができます。 Web サービスをインストールするには、SharePoint Services コンピューターで BizTalk Server インストールを実行し、Windows SharePoint Services アダプターチェックします。 特定のインストール手順については、「 付録 B: Microsoft SharePoint アダプター をインストールする」を参照してください。 |
クライアント OM を [はい] に設定することをお勧めします。 [はい] に設定すると、Web サービスは SharePoint コンピューターにインストールされません。 Web サービス オプションを使用する場合は、BizTalk Serverで [クライアント OM の使用] を [いいえ] に設定する必要があります。
IIS
BTSharePointAdapterWS.asmx Web サービス
Windows SharePoint Services アダプターが SharePoint コンピューターにインストールされると、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 データベースがすべて同じコンピューターにインストールされている場合は、ローカル アカウントを使用できます。
ダブルホップ のシナリオ
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>」を参照してください。IIS/SharePoint コンピューターでSQL Server サービスとアプリケーション プールを実行するドメイン アカウントには、サービス プリンシパル名 (SPN) が必要です。 サービス プリンシパル名の構成の詳細については、「 サービス プリンシパル名 (SPN)」を参照してください。
Windows 8、Windows Server 2008 SP2、Windows Server 2008 R2、Windows Server 2012: SetSPN
重要
SetSPN にはドメイン管理者権限が必要です。SetSPN はドメイン内の任意のコンピューターで実行できます。
ドメイン アカウントに登録されているすべての SPN の一覧を取得するには:
setspn.exe -l Domain\UserAccountSPN を作成します。
IIS/SharePoint コンピューターの FQDN の SPN を作成します。
setspn.exe -s http/IISSharePointComputerName.domain.com domain\IISApplicationPoolDomainAccountIIS/SharePoint コンピューターの NETBIOS 名の SPN を作成します。
setspn.exe -s http/IISSharePointComputerNamedomain\IISApplicationPoolDomainAccountIIS/SharePoint コンピューターによって使用される SQL Server コンピューターの FQDN の SPN を作成します。
setspn.exe -s mssqlsvc/SQLComputerName.domain.com domain\SQLServerServiceDomainAccountIIS/SharePoint コンピューターによって使用される SQL Server コンピューターの FQDN および TCP ポートの SPN を作成します。
setspn.exe -s mssqlsvc/SQLComputerName.domain.com:1433 domain\SQLServerServiceDomainAccountIIS/SharePoint コンピューターによって使用される SQL Server コンピューターの NETBIOS 名の SPN を作成します。
setspn.exe -s mssqlsvc/SQLComputerNamedomain\SQLServerServiceDomainAccountIIS/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 アダプターの構成