Использование Microsoft Graph Data Connect для определения область набора данных

В этой статье объясняется концепция групп в Microsoft Graph Data Connect и параметры область выбора. Выбор области позволяет указать способ извлечения объектов; Например, можно извлечь объекты для всех пользователей в клиенте Microsoft 365 или выбрать группы в клиенте Microsoft 365. Дополнительные сведения см. в разделе Демистификация областей пользователей.

В Центр администрирования Microsoft 365 можно создать несколько различных типов групп и управлять ими. Дополнительные сведения см. в разделе Сравнение групп. К Microsoft Graph Data Connect применяются следующие типы групп:

  • Группы Microsoft 365 — используется для совместной работы пользователей как внутри организации, так и за ее пределами. К ним относятся службы для совместной работы, например SharePoint и Планировщик.
  • Группы рассылки — используется для отправки Уведомления по электронной почте группе людей.
  • Группы безопасности — используется для предоставления доступа к ресурсам, таким как сайты SharePoint.
  • Группы безопасности с поддержкой почты — используются для предоставления доступа к таким ресурсам, как SharePoint, и отправки уведомлений по электронной почте этим пользователям.

Выбор области в Microsoft Graph Data Connect

Наборы данных Microsoft Graph Data Connect можно область пользователями или группами. В следующих разделах содержатся сведения о параметрах область для каждого из них.

Наборы данных на уровне пользователя

Наборы данных уровня пользователя могут быть сообщениями, событиями, пользователями и т. д. Эти наборы данных сосредоточены на данных вокруг отдельного пользователя для соответствующего набора данных.

Ниже приведены параметры для наборов данных на уровне пользователя.

  • Все пользователи в клиенте. Возвращает данные для всех пользователей в клиенте. Данные извлекаются для отдельных пользователей в выбранной группе. Дополнительные сведения см. в разделе Возможности выбора пользователей и фильтрации.
  • Все пользователи в клиенте с фильтром область. Возвращает данные для всех пользователей в клиенте, которые являются частью примененного фильтра область. Данные извлекаются для отдельных пользователей из выбранного фильтра (группы). Фильтр область помогает фильтровать пользователей. Если он остается пустым, возвращаются все данные для всех пользователей.
  • Выберите группы из клиента Microsoft 365: данные извлекаются для отдельных пользователей в группе.

Пример

Клиент хочет извлечь набор данных сообщений и создать группу безопасности пользователей A, B и C в клиенте из 500 пользователей и передает эту группу. Microsoft Graph Data Connect расширяет группу безопасности в список пользователей, извлекает данные сообщений для этих пользователей и доставляет данные для этих пользователей клиенту. Клиент будет получать набор данных сообщений только для отдельных пользователей A, B и C из своего клиента из 500 пользователей.

Наборы данных на уровне группы

Наборы данных для группы могут быть групповыми беседами Outlook, сообщениями канала Teams, сведениями о группе. Эти наборы данных сосредоточены на коллективных данных в группе из Outlook или Teams.

Ниже приведены параметры для наборов данных на уровне группы.

  • Все группы в клиенте. Возвращает данные для всех групп в клиенте.
  • Все группы в клиенте с фильтром область. Возвращает данные для всех групп в клиенте с примененным фильтром область. Фильтр область помогает сузить список групп.
  • Выбор групп из клиента Microsoft 365. Возвращает коллективные данные для выбранных групп. Microsoft Graph Data Connect ищет данные, связанные с этими конкретными группами, а не отдельными пользователями группы.

Заметка: Когда клиент указывает группу или группы, которые будут область, Microsoft Graph Data Connect ищет данные, связанные с этими конкретными группами, а не отдельных лиц группы.

В следующей таблице сопоставлены определенные наборы данных с определенными типами групп. Это помогает понять, какие типы групп совместимы с наборами данных при извлечении данных и использовании область фильтров. Группы могут быть группами рассылки, группами безопасности или группами Microsoft 365. Поддерживаемые типы групп зависят от запрашиваемого набора данных.

Набор данных Группа Microsoft 365 Группа рассылки. Группа безопасности Группа безопасности с поддержкой электронной почты
TeamsStandardChannelMessages Да* Нет Нет Нет
TeamsChannelDetails_v0 Да* Нет Нет Нет
OutlookGroupConversationsations Да Нет Нет Нет
GroupDetails Да Да Да Да
GroupMembers Да Да Да Да
GroupOwners Да Да** Да** Да
Viva Insights Недоступно Недоступно Недоступно Недоступно
OneDrive и SharePoint Online Недоступно Недоступно Недоступно Недоступно
Все остальные наборы данных Да Да Да Да

*Для наборов данных Teams группы Microsoft 365 также должны быть включены в Teams.

**Наборы данных группы не содержат основной почтовый ящик; регион по умолчанию — регион клиента.

Пример

Клиент хочет извлечь набор данных сведений о группе с группой безопасности пользователей A, B и C из своего клиента из 500 пользователей. Так как это набор данных на уровне группы, клиент будет получать только сведения о группе для указанной группы. Клиент не будет получать отдельные данные о пользователях A, B и C в группе.

Заметка: Если группа в область не является группой с поддержкой Teams, она не вернет никаких данных для наборов данных Teams. Группы Microsoft 365 можно включить как группы Teams, но группы рассылки и группы безопасности не включены в Teams. В следующем разделе содержатся сведения о типах групп, доступных для выбора.

Поиск и проверка типов групп

Выполните следующие действия, чтобы найти типы групп в клиенте, чтобы определить, что совместимо с типом область, который вы хотите выбрать:

  1. Войдите на портал ADF, выберите клиент и выберите Источник.

  2. На вкладке Область выберите набор данных с областью действия группы, найдите и добавьте группу или группы или идентификаторы групп и нажмите кнопку Добавить.

    Снимок экрана: портал ADF с выделенной кнопкой

  3. Просмотрите идентификатор группы. Скопируйте идентификаторы групп, которые требуется проверить.

    Снимок экрана: портал ADF с выделенным списком групп и идентификаторов групп

  4. На новой вкладке перейдите к Центр администрирования Microsoft Entra> в разделе Удостоверение выберите Обзор.

  5. На вкладке Обзор вставьте идентификатор группы, скопированный из шага 2, а затем выберите вкладку Группы .

    Снимок экрана: Центр администрирования Microsoft Entra с выделенным полем идентификатора группы и вкладкой

  6. В поле Тип группы проверьте тип группы.

    Снимок экрана: группа с выделенным полем