Поделиться через

Группы и пользователи MS Graph

Соединитель групп и пользователей MS Graph помогает получить группы идентификаторов Microsoft Entra, члены (пользователи) и сведения о лицензии

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Джей Джани, Корпорация Майкрософт
Адрес электронной почты jayjani@microsoft.com
Метаданные соединителя
Publisher Джей Джани
Website https://graph.microsoft.com
Политика конфиденциальности https://privacy.microsoft.com/en-us/privacystatement
Категории ИТ-операции; Данные

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

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

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

List Subscribed Skus

Сведения о номерах SKU плана лицензий, подписанных организацией
Вывод списка прямых членов группы

Получение прямых членов группы с подсчетом
Получение групп участников

Членство в группах для пользователя (участника)
Получение сведений о лицензии участника

Получение сведений о лицензии участника группы (пользователя)
Получение свойств группы

Получение свойств и связей группы идентификаторов Microsoft Entra
Список групп по поиску отображаемого имени

Получение групп с помощью отображаемого имени группы поиска
Список пользователей

Получение всех пользователей в организации (клиент Идентификатора Microsoft Entra)

List Subscribed Skus

Идентификатор операции:
ListSubscribedSkus

Сведения о номерах SKU плана лицензий, подписанных организацией

Возвращаемое значение

Имя Путь Тип Описание
Контекст Odata
 @odata.context string

Ссылка Odata.context.
value
 value array of object

value
Состояние возможности
 value.capabilityStatus string

Состояние SKU возможностей
Потребляемые единицы
 value.consumedUnits integer

Сколько единиц SKU уже используется?
Идентификатор
 value.id string

id
Идентификатор SKU
 value.skuId string

Глобальный уникальный идентификатор SKU
Номер части SKU
 value.skuPartNumber string

Название SKU
Применимо к
 value.appliesTo string

К кому применяется номер SKU?
Включен
 value.prepaidUnits.enabled integer

Включенные единицы
Приостановлена
 value.prepaidUnits.suspended integer

Приостановленные единицы
Предупреждение
 value.prepaidUnits.warning integer

Единицы в предупреждении
servicePlans
 value.servicePlans array of object

servicePlans
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
provisioningStatus
 value.servicePlans.provisioningStatus string

provisioningStatus
применяетсяК
 value.servicePlans.appliesTo string

применяетсяК

Вывод списка прямых членов группы

Идентификатор операции:
ListDirectGroupMembers

Получение прямых членов группы с подсчетом

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор объекта группы идентификаторов Microsoft Entra
 group-id True string

Идентификатор объекта группы идентификаторов Microsoft Entra
Фильтрация по
 $filter string

Фильтрация по
Выбор точки данных (столбец)
 $select string

Выбор столбцов для получения

Возвращаемое значение

Имя Путь Тип Описание
Контекст Odata
 @odata.context string

Ссылка Odata.context.
Число Odata
 @odata.count integer

@odata.count
value
 value array of object

value
Тип Odata
 value.@odata.type string

@odata.type
Отображаемое имя
 value.displayName string

Полное имя участника
Основное имя пользователя
 value.userPrincipalName string

Имя субъекта-пользователя участника
Идентификатор
 value.id string

Идентификатор объекта для члена
Должность
 value.jobTitle string

Название должности
Имя почтового ящика
 value.mailNickname string

Имя участника электронной почты
Mail
 value.mail string

Электронная почта участника
Заданное имя
 value.givenName string

Имя участника
Surname
 value.surname string

Фамилия участника
businessPhones
 value.businessPhones array of string

businessPhones
Мобильный телефон
 value.mobilePhone string

мобильный телефон
Расположение Office
 value.officeLocation string

officeLocation
Предпочтительный язык
 value.preferredLanguage string

Предпочтительный язык, настроенный в идентификаторе Microsoft Entra.

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

Идентификатор операции:
GetMemberGroups

Членство в группах для пользователя (участника)

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор объекта участника Microsoft Entra ID(user)
 member-id True string

Идентификатор объекта участника Microsoft Entra ID(user)
Включена только безопасность (true/false)
 securityEnabledOnly True boolean

Вы хотите получить только группы с поддержкой безопасности?

Возвращаемое значение

Имя Путь Тип Описание
Контекст Odata
 @odata.context string

Ссылка Odata.context.
value
 value array of string

value

Получение сведений о лицензии участника

Идентификатор операции:
GetMemberLicenseDetails

Получение сведений о лицензии участника группы (пользователя)

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор объекта участника Microsoft Entra ID(user)
 id True string

Идентификатор объекта участника Microsoft Entra ID(user)
Выбор точек данных (столбцов)
 $select string

Выбор точек данных (столбцов)

Возвращаемое значение

Имя Путь Тип Описание
Контекст Odata
 @odata.context string

Ссылка Odata.context.
value
 value array of object

value
Идентификатор
 value.id string

id
Идентификатор SKU
 value.skuId string

Идентификатор номера SKU.
Номер части SKU
 value.skuPartNumber string

Название SKU
servicePlans
 value.servicePlans array of object

servicePlans
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
provisioningStatus
 value.servicePlans.provisioningStatus string

provisioningStatus
применяетсяК
 value.servicePlans.appliesTo string

применяетсяК

Получение свойств группы

Идентификатор операции:
GetGroupProperties

Получение свойств и связей группы идентификаторов Microsoft Entra

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор объекта группы идентификаторов Microsoft Entra
 group-id True string

Идентификатор объекта группы идентификаторов Microsoft Entra

Возвращаемое значение

Имя Путь Тип Описание
Контекст Odata
 @odata.context string

Ссылка Odata.context.
Идентификатор
 id string

Идентификатор объекта группы
Удаленное время даты
 deletedDateTime string

Время удаления группы
Classification
 classification string

classification
Время создания даты
 createdDateTime string

Дата создания группы
creationOptions
 creationOptions array of string

Созданные параметры группы.
Description
 description string

описание
Отображаемое имя
 displayName string

Отображаемое имя группы
Время окончания срока действия
 expirationDateTime string

Время окончания срока действия группы
groupTypes
 groupTypes array of string

Типы групп для группы.
Можно назначить роли
 isAssignableToRole string

Можно ли назначить роль этой группе?
Mail
 mail string

Электронная почта группы
Почта включена
 mailEnabled boolean

Включена ли группа электронной почты?
Имя почтового ящика
 mailNickname string

Имя ника электронной почты группы
Правило членства
 membershipRule string

Правило, используемое для оценки членства.
Состояние обработки правил членства
 membershipRuleProcessingState string

Состояние обработки правила, используемого для оценки членства.
Доменное имя OnPremises
 onPremisesDomainName string

Содержит локальный доменFQDN, который также называется dnsDomainName, синхронизированным из локального каталога.
Время последней синхронизации OnPremises
 onPremisesLastSyncDateTime string

Время и дата последнего синхронизации клиента с локальным каталогом.
OnPremises NetBios Name
 onPremisesNetBiosName string

Имя сетевой службы для локального сервера.
Имя учетной записи Sam OnPremises
 onPremisesSamAccountName string

Имя учетной записи Sam для локального каталога.
Идентификатор безопасности OnPremises
 onPremisesSecurityIdentifier string

Локальный идентификатор безопасности.
Включена синхронизация OnPremises
 onPremisesSyncEnabled boolean

Значение True, если локальная синхронизация включена для группы.
Предпочтительное расположение данных
 preferredDataLocation string

Предпочтительное расположение данных группы.
Предпочтительный язык
 preferredLanguage string

Предпочтительный язык, настроенный в идентификаторе Microsoft Entra.
прокси-адреса
 proxyAddresses array of string

Прокси-адреса группы.
Продленное время даты
 renewedDateTime string

Продленное время даты группы.
resourceBehaviorOptions
 resourceBehaviorOptions array of string

Параметры поведения ресурсов группы.
resourceProvisioningOptions
 resourceProvisioningOptions array of string

Параметры подготовки ресурсов группы.
Включена безопасность
 securityEnabled boolean

Указывает, включена ли группа безопасности.
Идентификатор безопасности
 securityIdentifier string

Идентификатор безопасности группы.
Тема
 theme string

Тема группы идентификаторов Microsoft Entra.
Видимость
 visibility string

Видимость группы.
onPremisesProvisioningErrors
 onPremisesProvisioningErrors array of string

В локальной среде ошибки подготовки группы.

Список групп по поиску отображаемого имени

Идентификатор операции:
ListGroupsByDisplayNameSearch

Получение групп с помощью отображаемого имени группы поиска

Параметры

Имя Ключ Обязательно Тип Описание
Поиск по отображаемого имени
 $search string

Поиск по ключевому слову в отображаемом имени группы идентификаторов Microsoft Entra

Возвращаемое значение

Имя Путь Тип Описание
Контекст Odata
 @odata.context string

Ссылка Odata.context.
Количество групп
 @odata.count integer

@odata.count
value
 value array of object

value
Идентификатор
 value.id string

Идентификатор объекта группы
Удаленное время даты
 value.deletedDateTime string

Дата и время удаления группы
Classification
 value.classification string

Классификация группы
Время создания даты
 value.createdDateTime string

Дата и время создания группы
creationOptions
 value.creationOptions array of

Созданные параметры группы.
Description
 value.description string

Описание группы
Отображаемое имя
 value.displayName string

Отображаемое имя группы
Время окончания срока действия
 value.expirationDateTime string

Время окончания срока действия группы
groupTypes
 value.groupTypes array of string

Типы групп для группы.
Можно назначить роли
 value.isAssignableToRole string

Можно ли назначить роль этой группе?
Mail
 value.mail string

Электронная почта группы
Почта включена
 value.mailEnabled boolean

Включена ли группа электронной почты?
Имя почтового ящика
 value.mailNickname string

Имя ника электронной почты группы
Правило членства
 value.membershipRule string

Правило, используемое для оценки членства.
Состояние обработки правил членства
 value.membershipRuleProcessingState string

Состояние обработки правила, используемого для оценки членства.
Доменное имя OnPremises
 value.onPremisesDomainName string

Содержит локальный доменFQDN, который также называется dnsDomainName, синхронизированным из локального каталога.
Время последней синхронизации OnPremises
 value.onPremisesLastSyncDateTime string

Время и дата последнего синхронизации клиента с локальным каталогом.
OnPremises NetBios Name
 value.onPremisesNetBiosName string

Имя сетевой службы для локального сервера.
Имя учетной записи Sam OnPremises
 value.onPremisesSamAccountName string

Имя учетной записи Sam для локального каталога.
Идентификатор безопасности OnPremises
 value.onPremisesSecurityIdentifier string

Локальный идентификатор безопасности.
Включена синхронизация OnPremises
 value.onPremisesSyncEnabled boolean

Значение True, если локальная синхронизация включена для группы.
Предпочтительное расположение данных
 value.preferredDataLocation string

Предпочтительное расположение данных группы.
Предпочтительный язык
 value.preferredLanguage string

Предпочтительный язык, настроенный в идентификаторе Microsoft Entra.
прокси-адреса
 value.proxyAddresses array of string

Прокси-адреса группы.
Продленное время даты
 value.renewedDateTime string

Продленное время даты группы.
resourceBehaviorOptions
 value.resourceBehaviorOptions array of

Параметры поведения ресурсов группы.
resourceProvisioningOptions
 value.resourceProvisioningOptions array of string

Параметры подготовки ресурсов группы.
Включена безопасность
 value.securityEnabled boolean

Указывает, включена ли группа безопасности.
Идентификатор безопасности
 value.securityIdentifier string

Идентификатор безопасности группы.
Тема
 value.theme string

Тема группы идентификаторов Microsoft Entra.
Видимость
 value.visibility string

Видимость группы.
onPremisesProvisioningErrors
 value.onPremisesProvisioningErrors array of

В локальной среде ошибки подготовки группы.

Список пользователей

Идентификатор операции:
ListUsers

Получение всех пользователей в организации (клиент Идентификатора Microsoft Entra)

Возвращаемое значение

Имя Путь Тип Описание
@odata.context
 @odata.context string

Ссылка Odata.context.
value
 value array of object

value
businessPhones
 value.businessPhones array of string

businessPhones
Отображаемое имя
 value.displayName string

Полное имя пользователя
Заданное имя
 value.givenName string

Имя пользователя
Должность
 value.jobTitle string

Название задания пользователя
Mail
 value.mail string

Электронная почта пользователя
Мобильный телефон
 value.mobilePhone string

Мобильный телефон пользователя
Расположение Office
 value.officeLocation string

Расположение офиса пользователя
Предпочтительный язык
 value.preferredLanguage string

Предпочтительный язык пользователя
Surname
 value.surname string

Фамилия пользователя
Основное имя пользователя
 value.userPrincipalName string

Имя участника пользователя
Идентификатор
 value.id string

Идентификатор объекта пользователя