MS Graph 组和用户

MS Graph 组和用户连接器可帮助检索Microsoft Entra ID 组、成员（用户）和许可证详细信息

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	杰伊·贾尼，Microsoft
Email	jayjani@microsoft.com

连接器元数据
发布者	Jay Jani
网站	`https://graph.microsoft.com`
隐私策略	https://privacy.microsoft.com/en-us/privacystatement
类别	IT作;数据

正在创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

列出用户	检索组织中的所有用户（Microsoft Entra ID 租户）
列出直接组成员	检索包含计数的组的直接成员
列出订阅的 SKU	组织订阅的许可证计划 SKU 的详细信息
按显示名称搜索列出组	通过搜索组的显示名称检索组
获取成员组	用户（成员）的组成员身份
获取成员许可证详细信息	检索组成员（用户）的许可证详细信息
获取组属性	检索Microsoft Entra ID 组的属性和关系

列出用户

操作 ID:: ListUsers

检索组织中的所有用户（Microsoft Entra ID 租户）

名称	路径	类型	说明
@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	用户的职务
邮件	value.mail	string	用户的电子邮件
移动电话	value.mobilePhone	string	用户的移动电话
Office 位置	value.officeLocation	string	用户的办公室位置
首选语言	value.preferredLanguage	string	用户的首选语言
Surname	value.surname	string	用户的姓氏
用户主体名称	value.userPrincipalName	string	用户的主体名称
ID	value.id	string	用户的对象 ID

列出直接组成员

操作 ID:: ListDirectGroupMembers

检索包含计数的组的直接成员

参数

名称	密钥	必需	类型	说明
Microsoft Entra ID 组的对象 ID	group-id	True	string	Microsoft Entra ID 组的对象 ID
筛选依据	$filter		string	筛选依据
数据点（列）选择	$select		string	选择要检索的列

名称	路径	类型	说明
Odata 上下文	@odata.context	string	Odata.context 链接。
Odata Count	@odata.count	integer	@odata.count
value	value	array of object	value
Odata 类型	value.@odata.type	string	@odata.type
显示名称	value.displayName	string	成员的全名
用户主体名称	value.userPrincipalName	string	成员的用户主体名称
ID	value.id	string	成员的对象 ID
职务	value.jobTitle	string	职位名称
邮件尼克名称	value.mailNickname	string	成员的电子邮件昵称
邮件	value.mail	string	成员的电子邮件
名	value.givenName	string	成员的名字
Surname	value.surname	string	成员的姓氏
businessPhones	value.businessPhones	array of string	businessPhones
移动电话	value.mobilePhone	string	mobilePhone
Office 位置	value.officeLocation	string	officeLocation
首选语言	value.preferredLanguage	string	Microsoft Entra ID 中配置的首选语言。

列出订阅的 SKU

操作 ID:: ListSubscribedSkus

组织订阅的许可证计划 SKU 的详细信息

名称	路径	类型	说明
Odata 上下文	@odata.context	string	Odata.context 链接。
value	value	array of object	value
功能状态	value.capabilityStatus	string	SKU 的功能状态
已使用单位	value.consumedUnits	integer	已使用多少 SKU 单位？
ID	value.id	string	id
SKU ID	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
provisioning状态	value.servicePlans.provisioningStatus	string	provisioning状态
应用到	value.servicePlans.appliesTo	string	应用到

按显示名称搜索列出组

操作 ID:: ListGroupsByDisplayNameSearch

通过搜索组的显示名称检索组

参数

名称	密钥	必需	类型	说明
按显示名称搜索	$search		string	按关键字搜索Microsoft Entra ID 组的显示名称

名称	路径	类型	说明
Odata 上下文	@odata.context	string	Odata.context 链接。
组数	@odata.count	integer	@odata.count
value	value	array of object	value
ID	value.id	string	组的对象 ID
已删除日期时间	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	是否可以将此角色分配到此组？
邮件	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 名称	value.onPremisesNetBiosName	string	本地服务器的网络服务的名称。
OnPremises Sam 帐户名称	value.onPremisesSamAccountName	string	本地目录的 Sam 帐户名称。
OnPremises 安全标识符	value.onPremisesSecurityIdentifier	string	本地安全标识符。
已启用 OnPremises 同步	value.onPremisesSyncEnabled	boolean	如此如果为组启用了本地同步。
首选数据位置	value.preferredDataLocation	string	组的首选数据位置。
首选语言	value.preferredLanguage	string	Microsoft Entra ID 中配置的首选语言。
代理地址	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 ID 组的主题。
能见度	value.visibility	string	组的可见性。
onPremisesProvisioningErrors	value.onPremisesProvisioningErrors	array of	组的本地预配错误。

获取成员组

操作 ID:: GetMemberGroups

用户（成员）的组成员身份

参数

名称	密钥	必需	类型	说明
Microsoft Entra ID 成员的对象 ID（用户）	member-id	True	string	Microsoft Entra ID 成员的对象 ID（用户）
仅启用安全性（true/false）	securityEnabledOnly	True	boolean	是否仅检索已启用安全性的组？

名称	路径	类型	说明
Odata 上下文	@odata.context	string	Odata.context 链接。
value	value	array of string	value

获取成员许可证详细信息

操作 ID:: GetMemberLicenseDetails

检索组成员（用户）的许可证详细信息

参数

名称	密钥	必需	类型	说明
Microsoft Entra ID 成员的对象 ID（用户）	id	True	string	Microsoft Entra ID 成员的对象 ID（用户）
选择数据点（列）	$select		string	选择数据点（列）

名称	路径	类型	说明
Odata 上下文	@odata.context	string	Odata.context 链接。
value	value	array of object	value
ID	value.id	string	id
SKU ID	value.skuId	string	SKU 的 ID。
SKU 部件号	value.skuPartNumber	string	SKU 的名称
servicePlans	value.servicePlans	array of object	servicePlans
servicePlanId	value.servicePlans.servicePlanId	string	servicePlanId
servicePlanName	value.servicePlans.servicePlanName	string	servicePlanName
provisioning状态	value.servicePlans.provisioningStatus	string	provisioning状态
应用到	value.servicePlans.appliesTo	string	应用到

获取组属性

操作 ID:: GetGroupProperties

检索Microsoft Entra ID 组的属性和关系

参数

名称	密钥	必需	类型	说明
Microsoft Entra ID 组的对象 ID	group-id	True	string	Microsoft Entra ID 组的对象 ID

名称	路径	类型	说明
Odata 上下文	@odata.context	string	Odata.context 链接。
ID	id	string	组的对象 ID
已删除日期时间	deletedDateTime	string	组的删除日期时间
Classification	classification	string	分类
创建日期时间	createdDateTime	string	组的创建日期时间
creationOptions	creationOptions	array of string	已创建组的选项。
Description	description	string	描述
显示名称	displayName	string	组的显示名称
到期日期时间	expirationDateTime	string	组的到期日期时间
groupTypes	groupTypes	array of string	组的组类型。
可分配给角色	isAssignableToRole	string	是否可以将此角色分配到此组？
邮件	mail	string	组的电子邮件
已启用邮件	mailEnabled	boolean	是否已启用组电子邮件？
邮件尼克名称	mailNickname	string	组的电子邮件昵称
成员身份规则	membershipRule	string	用于成员身份评估的规则。
成员身份规则处理状态	membershipRuleProcessingState	string	用于成员身份评估的规则的处理状态。
OnPremises 域名	onPremisesDomainName	string	包含本地域FQDN，也称为从本地目录同步的 dnsDomainName。
OnPremises 上次同步日期时间	onPremisesLastSyncDateTime	string	租户上次与本地目录同步的时间和日期。
OnPremises NetBios 名称	onPremisesNetBiosName	string	本地服务器的网络服务的名称。
OnPremises Sam 帐户名称	onPremisesSamAccountName	string	本地目录的 Sam 帐户名称。
OnPremises 安全标识符	onPremisesSecurityIdentifier	string	本地安全标识符。
已启用 OnPremises 同步	onPremisesSyncEnabled	boolean	如此如果为组启用了本地同步。
首选数据位置	preferredDataLocation	string	组的首选数据位置。
首选语言	preferredLanguage	string	Microsoft Entra ID 中配置的首选语言。
代理地址	proxyAddresses	array of string	组的代理地址。
续订的日期时间	renewedDateTime	string	组的续订日期时间。
resourceBehaviorOptions	resourceBehaviorOptions	array of string	组的资源行为选项。
resourceProvisioningOptions	resourceProvisioningOptions	array of string	组的资源预配选项。
已启用安全性	securityEnabled	boolean	指示组是否已启用安全性。
安全标识符	securityIdentifier	string	组的安全标识符。
主题	theme	string	Microsoft Entra ID 组的主题。
能见度	visibility	string	组的可见性。
onPremisesProvisioningErrors	onPremisesProvisioningErrors	array of string	组的本地预配错误。

通过

返回

参数

返回

返回

参数

返回

参数

返回

参数

返回

参数

返回