この記事では、Microsoft Graph Data Connect のグループの概念と、スコープ選択のオプションについて説明します。 スコープを選択すると、オブジェクトを抽出する方法を指定できます。たとえば、Microsoft 365 テナント内のすべてのユーザーのオブジェクトを抽出したり、Microsoft 365 テナント内のグループを選択したりできます。 詳細については、「 ユーザー スコープの解明」を参照してください。
Microsoft 365 管理センターでは、さまざまな種類のグループを作成および管理できます。詳細については、「グループの比較」を参照してください。 Microsoft Graph Data Connect には、次の種類のグループが適用されます。
- Microsoft 365 グループ - 社内外のユーザー間のコラボレーションに使用されます。 これには、SharePoint や Planner などのコラボレーション サービスが含まれます。
- 配布グループ - ユーザーのグループに電子メール通知を送信するために使用されます。
- セキュリティ グループ - SharePoint サイトなどのリソースへのアクセスを許可するために使用されます。
- メールが有効なセキュリティ グループ - SharePoint などのリソースへのアクセスを許可したり、それらのユーザーに通知を電子メールで送信したりするために使用されます。
Microsoft Graph Data Connect でのスコープの選択
Microsoft Graph Data Connect データセットのスコープは、ユーザー別またはグループ別に指定できます。 次のセクションでは、それぞれのスコープ オプションの詳細について説明します。
ユーザー スコープデータセット
ユーザー スコープのデータセットには、メッセージ、イベント、ユーザーなどを指定できます。 これらのデータセットは、それぞれのデータセットの個々のユーザーに関するデータに焦点を当てています。
ユーザー スコープデータセットのオプションを次に示します。
- テナント内のすべてのユーザー: テナント内のすべてのユーザーのデータを返します。 選択したグループ内の個々のユーザーのデータが抽出されます。 詳細については、「 ユーザーの選択とフィルター処理の機能」を参照してください。
- スコープ フィルターを持つテナント内のすべてのユーザー: 適用されたスコープ フィルターの一部であるテナント内のすべてのユーザーのデータを返します。 選択したフィルター (グループ) から個々のユーザーのデータが抽出されます。スコープ フィルターは、ユーザーのフィルター処理に役立ちます。 空のままにすると、すべてのユーザーのすべてのデータが返されます。
- Microsoft 365 テナントからグループを選択する: グループ内の個々のユーザーのデータが抽出されます。
例
顧客がメッセージ データセットを抽出し、500 人のユーザーのテナントにユーザー A、B、C のセキュリティ グループを作成し、このグループを渡します。 Microsoft Graph Data Connect は、セキュリティ グループをユーザーの一覧に展開し、それらのユーザーのメッセージ データを抽出し、それらのユーザーのデータを顧客に配信します。 顧客は、500 人のユーザーのテナントから個々のユーザー A、B、C のメッセージ データセットのみを受信します。
グループスコープデータセット
グループ スコープのデータセットには、Outlook グループの会話、Teams チャネル メッセージ、グループの詳細を指定できます。 これらのデータセットは、Outlook または Teams のグループ内の集合データに焦点を当てます。
グループ スコープデータセットのオプションを次に示します。
- テナント内のすべてのグループ: テナント内のすべてのグループのデータを返します。
- スコープ フィルターがあるテナント内のすべてのグループ: スコープ フィルターが適用されたテナント内のすべてのグループのデータを返します。 スコープフィルターは、グループの一覧を絞り込むのに役立ちます。
- Microsoft 365 テナントからグループを選択する: 選択したグループの集合データを返します。 Microsoft Graph Data Connect は、グループの個人ではなく、これらの特定のグループに関連付けられているデータを検索します。
手記： ユーザーがスコープとしてグループまたはグループを指定すると、Microsoft Graph Data Connect は、グループの個人ではなく、それらの特定のグループに関連付けられているデータを検索します。
次の表は、特定のデータセットを特定の種類のグループにマップします。 これにより、データを抽出してスコープ フィルターを使用するときに、どの種類のグループがどのデータセットと互換性があるかを理解するのに役立ちます。 グループは、配布グループ、セキュリティ グループ、または Microsoft 365 グループのいずれかです。 サポートされるグループの種類は、要求するデータセットによって異なります。
| データセット | Microsoft 365 グループ | 配布グループ | セキュリティ グループ | メールが有効なセキュリティ グループ |
|---|---|---|---|---|
| TeamsStandardChannelMessages | はい* | 不要 | 不要 | 不要 |
| TeamsChannelDetails_v0 | はい* | 不要 | 不要 | 不要 |
| OutlookGroupConversations | はい | 不要 | 不要 | 不要 |
| GroupDetails | はい | はい | はい | はい |
| GroupMembers | はい | はい | はい | はい |
| GroupOwners | はい | はい** | はい** | はい |
| Viva Insights | 該当なし | 該当なし | 該当なし | 該当なし |
| OneDrive と SharePoint Online | 該当なし | 該当なし | 該当なし | 該当なし |
| その他のすべてのデータセット | はい | はい | はい | はい |
*Teams データセットの場合、Microsoft 365 グループも Teams 対応である必要があります。
**グループ データセットにはプライマリ メールボックスが含まれません。リージョンの既定値はテナントのリージョンです。
例
顧客は、500 人のユーザーのテナントからユーザー A、B、C のセキュリティ グループを使用してグループの詳細データセットを抽出したいと考えています。 これはグループスコープのデータセットであるため、顧客は指定されたグループのグループ詳細データのみを受け取ります。 顧客は、グループ内のユーザー A、B、C の個々のデータを受け取りません。
手記： Teams グループスコープのデータセットの場合、スコープ内のグループが Teams 対応グループでない場合、データは返されません。 Microsoft 365 グループは Teams グループとして有効にできますが、配布グループとセキュリティ グループは Teams 対応ではありません。 次のセクションでは、選択できるグループの種類の詳細を示します。
グループの種類を検索して確認する
次の手順を使用して、テナント内のグループの種類を検索して、選択するスコープの種類との互換性を判断するのに役立ちます。
ADF ポータルにサインインし、テナントを選択し、[ソース] を選択 します。
[ スコープ ] タブで、グループスコープのデータセットを選択し、グループまたはグループを検索して追加するか、グループ ID を選択し、[ 追加] を選択します。
![[ユーザー グループの追加] と [追加] ボタンが強調表示されている ADF ポータルのスクリーンショット](images/data-connect-groups-1.png)
グループ ID を表示します。 確認するグループの ID をコピーします。
新しいタブで、Microsoft Entra 管理センターに移動し>[ID] の下にある [概要] を選択します。
[概要] タブで、手順 2 からコピーしたグループ ID を貼り付け、[ グループ ] タブを選択します。
![[グループ ID] フィールドと [グループ] タブが強調表示されているMicrosoft Entra 管理センターのスクリーンショット](images/data-connect-groups-3.png)
グループの [種類] フィールドで、使用しているグループの種類を確認します。
![[種類] フィールドが強調表示されているグループのスクリーンショット](images/data-connect-groups-4.png)