反馈 编辑

group：evaluateDynamicMembership

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

评估用户或设备是否为动态组的成员。 会返回成员资格规则以及评估中使用的其他详细信息。 可以通过以下方式完成此操作：

  • 评估用户或设备是否是指定动态组的成员。
  • 根据用户或设备的 ID 和成员身份规则评估用户或设备是否是动态组的成员。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

使用成员 ID 和组 ID 评估动态成员身份

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） 对于用户：Group.Read.All 和 User.Read.All、Directory.Read.All
对于设备：Group.Read.All 和 Device.Read.All、Directory.Read.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 不支持。

使用成员 ID 和成员身份规则评估动态成员身份

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） 对于用户：User.Read.All、Directory.Read.All
对于设备：Device.Read.All、Directory.Read.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 不支持。

HTTP 请求

POST /groups/{id}/evaluateDynamicMembership
POST /groups/evaluateDynamicMembership

请求标头

名称 说明
Authorization 持有者 {token}
Content-type application/json

请求正文

在请求正文中，提供所需的属性。

下表列出了评估组成员身份时所需的属性。

参数 类型 说明
memberId String collection memberId 是要评估的用户或设备的对象 ID。
membershipRule String collection 用于成员资格评估的规则。 如果未提供此属性，则会评估现有组的规则。 如果提供了此属性，则会评估用户或设备是否可以加入具有相同规则的组。 有关详细信息，请参阅 Azure Active Directory 中的组动态成员资格规则。

响应

如果成功，此方法将返回 200 OK 响应代码和 evaluateDynamicMembershipResult 对象。

示例

示例 1：评估用户或设备是否是现有组的成员

请求

下面展示了示例请求。

POST https://graph.microsoft.com/beta/groups/{id}/evaluateDynamicMembership
Content-type: application/json

{
  "memberId": "319b41e8-d9e4-42f8-bdc9-741113f48b33"
}

响应

下面展示了示例响应。

HTTP/1.1 200 OK
Content-type: application/json

{
  "membershipRule": "(user.displayName -startsWith \"EndTestUser\")",
  "membershipRuleEvaluationResult": true,
  "membershipRuleEvaluationDetails": {
    "expressionResult": true,
    "expression": "user.displayName -startsWith \"EndTestUser\"",
    "propertyToEvaluate": {
      "propertyName": "displayName",
      "propertyValue": "EndTestUser001"
    }
  }
}

示例 2：根据成员身份规则评估用户或设备是否为组的成员

请求

下面展示了示例请求。

POST https://graph.microsoft.com/beta/groups/evaluateDynamicMembership
Content-type: application/json

{
  "memberId": "319b41e8-d9e4-42f8-bdc9-741113f48b33",
  "membershipRule": "(user.displayName -startsWith \"EndTestUser\")"
}

响应

下面展示了示例响应。

HTTP/1.1 200 OK
Content-type: application/json

{
  "membershipRule": "(user.displayName -startsWith \"EndTestUser\")",
  "membershipRuleEvaluationResult": true,
  "membershipRuleEvaluationDetails": {
    "expressionResult": true,
    "expression": "user.displayName -startsWith \"EndTestUser\"",
    "propertyToEvaluate": {
      "propertyName": "displayName",
      "propertyValue": "EndTestUser001"
    }
  }
}