通过

identityAccounts：invokeAction

命名空间：microsoft.graph.security

对Microsoft Defender for Identity中观察到的标识帐户执行撤销帐户和强制密码重置等作。 此作允许代表已登录标识读取和执行标识安全作。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ❌ ❌ ❌

权限

要调用此 API，需要以下权限之一。 为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型 权限 (第一) 列出的最低特权
委派（工作或学校帐户） SecurityIdentitiesActions.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 SecurityIdentitiesActions.ReadWrite.All

重要

在具有工作或学校帐户的委托方案中，必须为登录用户分配受支持的Microsoft Entra角色或具有支持的角色权限的自定义角色。 安全管理员 是此作支持的最低特权角色。

HTTP 请求

POST /security/identities/identityAccounts/{identityAccountsId}/invokeAction

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。

请求正文

在请求正文中，提供参数的 JSON 表示形式。

下表列出了调用此作时所需的参数。

参数 类型 说明
accountId String 要对其执行作的帐户的标识符。
action microsoft.graph.security.action 要对帐户执行的作类型。 可能的值包括 disable、enable、forcePasswordReset、revokeAllSessions、requireUserToSignInAgain、markUserAsCompromised。
identityProvider microsoft.graph.security.identityProvider 与帐户关联的标识提供者。 可能的值包括 entraID、activeDirectory、okta。

下表显示了每种 作 值类型支持的标识提供者：

作值 说明 支持的标识提供者
禁用 禁用帐户。 帐户无法进行身份验证。 如果帐户最近登录，则无法访问资源。 activeDirectory, okta
启用 启用帐户。 activeDirectory, okta
ForcePasswordReset 强制重置帐户的密码。 activeDirectory
RevokeAllSessions 撤销帐户的所有活动会话。 okta

响应

如果成功，此作将在 200 OK 响应正文中返回响应代码和 invokeActionResult 。

示例

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/v1.0/security/identities/identityAccounts/0104216-0539-4838-88b1-55baafdc296b/invokeAction
Content-Type: application/json

{
  "accountId": "256db173-930a-4991-9061-0d51a9a93ba5",
  "action": "disable",
  "identityProvider": "activeDirectory"
}

响应

以下示例显示了相应的响应。

注意：为了提高可读性，可能缩短了此处显示的响应对象。

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

{
  "value": 
    {
      "accountId": "256db173-930a-4991-9061-0d51a9a93ba5",
      "action": "disable",
      "provider": "activeDirectory",
      "correlationId": "ed2f052b-2a01-4cd9-acb3-f6145f83e1a5"
    }
}

注意

当前范围中未涵盖与 Entra ID 相关的作。

  • Last updated on