次の方法で共有

SharePoint Server Microsoft Graph コネクタ

  • [アーティクル]

SharePoint サーバー グラフ コネクタを使用すると、organizationのユーザーは、オンプレミスの SharePoint サーバーに格納されているコンテンツを検索したり、特定のユース ケースやシナリオで Copilot のコンテンツを使用したりできます。 オンプレミス インスタンスからドキュメントとサイト ページをクロールします。

注:

Active Directory 同期は、SharePoint Server コンテンツ検索でセキュリティ トリミングを有効にするための前提条件です。

機能

  • 認証されたアカウントを使用して、SharePoint ドキュメントと Web ページをアクセス許可と共にクロールします。
  • アイテムに対するアクセス許可を持たないユーザーは、検索または Copilot の結果にアイテムを見つけることができません。
  • Lists、ユーザーがインデックス作成に含めることができるすべての使用可能なサイト コレクションを選択できます。
  • 除外機能を使用して、インデックス作成からサイトを除外します。
  • ユーザーが Copilot のクエリとプロンプトにコネクタ コンテンツを利用できるようにします。 機能の一部を次に示します。
    • ドキュメントの内容に関する質問をします。 たとえば 、ファイルに 記載されている現在の売上予測Sales_Report.docは何ですか。
    • ドキュメントの内容を要約します。 たとえば、ファイルを Sales_Report.doc要約します。
    • 既存のドキュメントを使用してコンテンツを作成します。 たとえば、ファイル Sales_Report.docを使用して営業担当者と共有する FAQ ドキュメントを作成します。

制限事項

  • コネクタでは、ドキュメントと Web ページのみがサポートされます。
  • 除外ルールでは、サイトのみが除外され、サイト内のコンテンツ タイプは除外されません。

使用を開始する前に

Graph コネクタ エージェントをインストールする

SharePoint オンプレミス コンテンツのインデックスを作成するには、Graph コネクタ エージェントをインストールして登録する必要があります。 詳細については、「 Graph コネクタ エージェントのインストール 」を参照してください。 Graph コネクタ エージェントは、SharePoint サーバーと同じコンピューター、または SharePoint オンプレミス サーバーにアクセスできるコンピューターにインストールできます。

各ソース (SharePoint Web アプリケーション) は、1 つの接続で構成できます。 1 つの Graph コネクタ エージェントを使用して、SharePoint オンプレミス ソースの複数の接続からコンテンツをソースできます。 エージェントへの接続数を 3 つのソースに制限し、最適なインジェスト率を確保することをお勧めします。

ユーザーは SharePoint サーバーへのフル コントロール アクセス権を持っているか、ファーム管理者である必要があります。ユーザーがアクセス許可を持っていない項目はスキップされます。

必須および省略可能な設定

Microsoft Graph コネクタをすぐに使い始めるために、セットアップ プロセスの手順は次の 2 つのグループに分かれています。

必須の設定 - セットアップ フローを入力したときに表示される既定のセットアップ画面。 接続を作成するには、これらのフィールドの入力を指定する必要があります。 入力 (接続名、データ ソースの設定など) は、organizationのコンテキストとユース ケースによって異なります。

カスタム セットアップ (省略可能な設定) - カスタム セットアップには、スーパー ユーザー向けの高度な構成手順があります。 手順は省略可能であり、便宜上、セットアップ プロセスの設定は、管理者が行った最も一般的な選択に基づいて既定値で事前に構成されています。 既定値をそのまま使用することも、organizationのニーズに合わせて変更することもできます。

作業の開始

SharePoint Server Microsoft Graph コネクタを追加します。

詳細については、一般的な セットアップ手順に関するページを参照してください。

Microsoft Graph Connector for SharePoint Server の接続作成画面を示すスクリーンショット 。

1. 表示名

表示名は、Copilot のユーザー向けの名前です。 データ ソースのコンテンツで識別するユーザーの適切な表示名を選択します。 名前は、Copilot エージェントに Graph コネクタの知識を追加するユーザーにも役立ちます。 表示名は、信頼されたコンテンツも示します。 表示名は、 コンテンツ ソース フィルターとしても使用されます。 このフィールドには既定値が存在しますが、organizationのユーザーが認識する名前にカスタマイズできます。

2. SharePoint インスタンス URL

SharePoint サイト/サイト コレクションの URL を、{domain}/sites/{site-name} https:// 形式で入力します。 コネクタはサイト URL を識別し、その Web アプリケーションに存在するすべてのサイト コレクションを一覧表示します。 管理者は、これらのサイト コレクションからコンテンツのインデックスを作成できます。

3. Graph コネクタ エージェントを選択する

テナントに登録されている使用可能な Graph コネクタ エージェントの一覧から選択します。

4. 認証

オプションのドロップダウン メニューから認証の種類を選択します。 現在サポートされているオプションは、Basic、Windows、Microsoft Entra IDです。

注:

Windows オプションを使用して SharePoint サーバー インスタンスに対して認証するには、ユーザー名に Domain\username 形式を使用します。

指定された資格情報で認証するには、[サインイン] をクリックして、使用可能なサイト コレクションの一覧を読み込む必要があります。

Microsoft SharePoint Server Graph コネクタのMicrosoft Entra ID ベースの認証

Entra ID ベースの認証方法を使用する前に、次の前提条件が満たされていることを確認してください。

  • Microsoft Entra ID ベースの認証は、Graph コネクタ エージェント バージョン 3.1.2.0 以降でサポートされています。 続行する前にエージェントをアップグレードします。 詳細については、「 Graph コネクタ エージェントのインストール 」を参照してください。
  • Microsoft Entra ID ベースの認証は、SharePoint Server Edition でのみサポートされます。 2024 年 11 月にリリースされたパス (パッチ 16.0.17928.20238) 以降を SharePoint Updatesから取得します。
  • Microsoft Entra IDを使用して OpenID Connect (OIDC) を設定する必要があります。 そのため、SharePoint で HTTPS を OpenID Connect (OIDC) ステップに HTTPS が必要として使用する必要があることを確認します。
手順
  1. Microsoft Entra ID Connect をダウンロードします。
  2. 手順に従って、Microsoft Entra ID Connect をインストールします。
  3. こちらの手順を使用して、Microsoft Entra IDで OpenID Connect (OIDC) を設定して有効にします。 この手順では、Azure portalでサード パーティ製アプリケーションを設定する必要があります。 この手順を実行する管理者権限があることを確認します。
"API を公開する" を構成する

  • 左側のナビゲーション ウィンドウから [API を公開する] タブに移動します。 アプリケーション ID URI が sharepoint サーバーの URL と一致していることを確認します。

    API 構成の公開を示すスクリーンショット。

  • [スコープの追加] をクリックし、スコープ名、管理者の同意の表示名、管理者の同意の説明にuser_impersonationを入力します。

  • [クライアント アプリケーションの追加] をクリックし、GCA のクライアント ID cb15c983-0c91-416f-8dc0-6c0e1de4ed42 と入力します。

    クライアント アプリケーションを追加する方法を示すスクリーンショット

  • スコープuser_impersonation確認します。

5. [サイト コレクション] を選択します

インデックスを作成するサイト コレクションを選択します。 サイト コレクションは、指定された SharePoint URL から識別される Web アプリケーションに属しています。 この一覧は、データ ソースで使用できるサイト コレクションの数に基づいて長い場合があります。

アカウントで使用できるサイト コレクションを示すスクリーンショット。

6. 限定対象ユーザーにロールアウトする

ロールアウトを広範な対象ユーザーに展開する前に、Copilot やその他の Search サーフェスで検証する場合は、制限付きユーザー ベースにこの接続をデプロイします。 制限付きロールアウトの詳細については、「 段階的なロールアウト」を参照してください。

この時点で、SharePoint の接続を作成する準備ができました。 [ 作成 ] をクリックして接続を発行し、選択したコンテンツにインデックスを付けることができます。

アクセス許可、データ除外ルール、スキーマ、クロール頻度などのその他の設定については、Jira データに最も適したものに基づいて既定値が設定されています。

7. 正常な作成

接続の作成が成功すると、コンテンツの同期が開始されます。 現時点では、管理者は接続の説明を提供するように求められます。 説明は、Copilot が接続コンテンツをより適切に検出するのに役立ちます。 目的のコンテンツの使用に関する接続の説明が適切であれば、Copilot 応答が適しています。 説明は、ユーザーが宣言型エージェントに適切な接続を選択する場合にも役立ちます。

成功画面を示すスクリーンショット。

カスタムセットアップ

カスタム設定は、設定の既定値を編集する管理者向けです。 [カスタム設定] オプションをクリックすると、[ユーザー]、[コンテンツ]、[同期] の 3 つのタブが表示されます。

任意の接続を編集すると、カスタム設定ウィンドウで常に開きます。

カスタム設定ウィンドウを示すスクリーンショット。

ユーザー

次のオプションを使用できます。

ユーザー 説明
アクセス許可 データ ソース内のコンテンツにアクセスできるユーザーのみがコンテンツを表示できます。(推奨)。
すべてのユーザー 接続はすべてのユーザーに開放されており、organization内のすべてのユーザーがコンテンツを表示できます。

注:

Graph コネクタは、ユーザー、セキュリティ グループ、および配布Listsをサポートします。 ただし、データ ソース (SharePoint Server) では、Access Control Listsとしての配布Listsはサポートされていません。 入れ子になった配布リストがある場合、それらの配布リストのメンバーは、Graph コネクタを介してコンテンツにアクセスすることもできます。

既定のオプションと推奨されるオプションは、コネクタがデータ ソースのアクセス許可を尊重し、許可されたユーザーのみが結果を表示できるオプションです。 organizationのすべてのユーザーが利用できるようにする場合は、"Everyone" に自由に変更できます。

[ユーザー] タブを示すスクリーンショット

SharePoint オンプレミス コネクタは、特定の項目に対する既存のアクセス制御リストをサポートします。 インデックス付きデータは検索結果に表示され、表示するアクセス許可を持つユーザーに表示されます。 Microsoft 365 エクスペリエンスは、Entra Id のアクセス許可を理解し、尊重します。 アイテムのアクセス制御Listsをサポートするには、Active Directory ID と Entra ID が同期されている必要があります。

コンテンツ

インデックス作成から除外するサイト URL を追加する

インデックス作成から除外するサイトの URL を追加します。 除外ルールは、サイトレベルまたはサブサイト レベルで機能します。 クロールから除外するサイト URL を追加します。 サイト コンテンツの URL を追加しないでください。 URL にドキュメントなどのサイト コンテンツが含まれている場合は、適用されません。 これらの URL から始まるすべてのサイト コンテンツまたはサブサイトを除外するには、URL の末尾に * を使用します。

URL が /*で終わる場合、この URL のプレフィックスが付いたすべての URL はクロールから除外されます。 たとえば、abc.com/private/* では、"/private" 内の abc.com/private/terms.html とすべてのコンテンツが除外されます。 ただし、除外する URL として abc.com/private/terms.html を指定した場合、除外ルールはサイトレベルまたはサブサイト レベルで機能するため適用されません。

除外ルールを示すスクリーンショット。

プロパティの管理

プロパティは、検索、クエリ、取得、および調整に使用できるデータを定義します。 これらの設定から、データ ソース プロパティの追加または削除、プロパティへのスキーマの割り当て (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加できます。

Source プロパティ Label 説明 Schema
コンテンツ これは、コンテンツのインデックスを作成するためです 検索
CreatedBy 作成者 アイテムを作成した所有者 クエリ、取得、検索
CreatedByUpn アイテムを作成した所有者のユーザー プリンシパル名 (UPN) クエリ、取得、検索
CreatedTime 作成日時 データ ソースでアイテムが作成されたデータと時刻 クエリ、取得
DocumentType ドキュメントの種類 取り戻す
IcnUrl IconUrl そのアイテムの種類に割り当てるアイコン URL 取り戻す
LastAccessed アイテムが最後にアクセスされたデータと時刻 クエリ、取得
LastModified 最終更新日時 アイテムが最後に変更されたデータと時刻 クエリ、取得
LastModifiedBy 作成者 アイテムを変更したユーザー クエリ、取得
LastModifiedByUpn アイテムを変更したユーザーのユーザー プリンシパル名 (UPN) 取得、検索
名前 タイトル Copilot やその他の検索エクスペリエンスに表示するアイテムのタイトル クエリ、取得、検索
ObjectType データ ソースから返されるオブジェクトの型 クエリ、取得、検索
Url アイテム URL 取り戻す

サイトで定義されているカスタム プロパティを追加して、ユーザーの検索または Copilot の結果をより適切に管理できます。 カスタム プロパティを追加するには、データ ソースから正確な文字列を指定する必要がある [プロパティの追加] をクリックします。 カスタム プロパティを構成するには、プロパティ名を定義し、データ型 (String、StringCollection、DateTime、Boolean、Int64、Double) を指定します。 カスタム プロパティは、SharePoint のカスタム列と一致します。 コネクタではクロール中に既存のプロパティと一致しないプロパティ名が無視されるため、プロパティ名を指定する場合は注意してください。 問題を回避するには、プロパティ名を二重チェックして、スペルが正しいことを確認します。

注:

現在、合計 128 のプロパティがサポートされています。 1 つの接続で複数のサイト コレクションを選択する場合は、既定のプロパティのみがサポートされます。 サイトで定義されているカスタム プロパティをサポートする場合は、別の接続を作成し、そのサイトのカスタム プロパティを追加します。

同期

更新間隔によって、データ ソースと Graph コネクタ インデックスの間でデータが同期される頻度が決まります。 更新間隔には、フル クロールと増分クロールの 2 種類があります。 詳細については、「 更新設定」を参照してください。

更新間隔の既定値:

同期 説明
増分クロール 頻度: 15 分ごと
フル クロール 頻度: 毎日

クロール スケジュールを示すスクリーンショット。

検索結果ページを設定する

接続を作成したら、垂直方向と結果の種類を使用して検索結果ページをカスタマイズする必要があります。 検索結果のカスタマイズについては、垂直方向と結果の種類を管理する方法に関するページを参照してください。