反馈 编辑

创建 unifiedRoleAssignmentMultiple

  • 项目

命名空间：microsoft.graph

重要

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

为 RBAC 提供程序创建新的 unifiedRoleAssignmentMultiple 对象。

目前支持以下 RBAC 提供程序：

  • 云电脑
  • Intune (设备)

For other Microsoft 365 applications (like Azure AD) ， use unifiedRoleAssignment.

权限

根据 RBAC 提供程序以及 (或应用程序) 类型，从下表中选择调用此 API 所需的最低特权权限。 若要了解 更多信息，包括在 选择更多特权权限之前保持谨慎，请参阅 权限。

对于云电脑提供商

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） CloudPC.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 CloudPC.ReadWrite.All

对于 Intune (设备) 提供程序

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） DeviceManagementRBAC.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 DeviceManagementRBAC.ReadWrite.All

HTTP 请求

若要为角色分配创建云电脑提供商：

POST /roleManagement/cloudPC/roleAssignments

若要创建角色分配 Intune 提供程序，

POST /roleManagement/deviceManagement/roleAssignments

请求标头

名称 说明
Authorization Bearer {token}。必需。
Content-type application/json. Required.

请求正文

在请求正文中，提供 unifiedRoleAssignmentMultiple 对象的 JSON 表示形式。 请求必须具有在 Azure AD 中定义的作用域（如 ）或特定于应用程序的范围（ directoryScopeIds 如 appScopeId ）。 例如Azure AD租户 (/") 、管理单元或应用程序。

响应

如果成功，此方法在响应正文中返回 响应代码和新的 201 Created unifiedRoleAssignmentMultiple 对象。

示例

示例 1：在 Intune 角色分配两个作用域组上创建一个 (，这两Azure AD对象)

请求

下面展示了示例请求。

注意**：roleDefinitionId** 的 roleTemplateId 的使用。 roleDefinitionId 可以是服务范围的模板 ID 或特定于目录 的 roleDefinitionId。

POST https://graph.microsoft.com/beta/roleManagement/deviceManagement/roleAssignments
Content-type: application/json

{ 
    "@odata.type": "#microsoft.graph.unifiedRoleAssignmentMultiple",
    "displayName": "My test role assignment 1",
    "roleDefinitionId": "c2cf284d-6c41-4e6b-afac-4b80928c9034",
    "principalIds": ["f8ca5a85-489a-49a0-b555-0a6d81e56f0d", "c1518aa9-4da5-4c84-a902-a31404023890"],
    "directoryScopeIds": ["28ca5a85-489a-49a0-b555-0a6d81e56f0d", "8152656a-cf9a-4928-a457-1512d4cae295"],
}

响应

下面展示了示例响应。

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

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#roleManagement/deviceManagement/roleAssignments/$entity",
    "@odata.type": "#microsoft.graph.unifiedRoleAssignmentMultiple",
    "id": "28ca5a85-489a-49a0-b555-0a6d81e56f0d",
    "roleDefinitionId": "c2cf284d-6c41-4e6b-afac-4b80928c9034",
    "principalIds": ["f8ca5a85-489a-49a0-b555-0a6d81e56f0d", "c1518aa9-4da5-4c84-a902-a31404023890"],
    "directoryScopeIds": ["28ca5a85-489a-49a0-b555-0a6d81e56f0d", "8152656a-cf9a-4928-a457-1512d4cae295"]
}

示例 2：在 Intune 角色分配"所有设备"的 Intune 中创建一个应用

使用以下信息创建 Intune 角色分配：

  • 若要允许在所有 Intune 设备上进行分配，请使用 AllDevices appScopeIds 中的值。
  • 若要允许分配所有 Intune 许可用户，请使用 AllLicensedUsers appScopeIds 中的值。
  • 若要允许分配所有 Intune 设备和许可用户，请使用 / directoryScopeIds 中的值。

请求

下面展示了示例请求。

POST https://graph.microsoft.com/beta/roleManagement/deviceManagement/roleAssignments
Content-type: application/json

{
    "@odata.type": "#microsoft.graph.unifiedRoleAssignmentMultiple",
    "displayName": "My test role assignment 1",
    "roleDefinitionId": "c2cf284d-6c41-4e6b-afac-4b80928c9034",
    "principalIds": ["f8ca5a85-489a-49a0-b555-0a6d81e56f0d", "c1518aa9-4da5-4c84-a902-a31404023890"],
    "appScopeIds": ["allDevices"]
}

响应

下面展示了示例响应。

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

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#roleManagement/deviceManagement/roleAssignments/$entity",
    "@odata.type": "#microsoft.graph.unifiedRoleAssignmentMultiple",
    "id": "28ca5a85-489a-49a0-b555-0a6d81e56f0d",
    "roleDefinitionId": "c2cf284d-6c41-4e6b-afac-4b80928c9034",
    "principalIds": ["f8ca5a85-489a-49a0-b555-0a6d81e56f0d", "c1518aa9-4da5-4c84-a902-a31404023890"],
    "appScopeIds": ["allDevices"]
}

示例 3：角色分配云电脑提供商

请求

POST https://graph.microsoft.com/beta/roleManagement/cloudPC/roleAssignments
Content-type: application/json

{ 
    "@odata.type": "#microsoft.graph.unifiedRoleAssignmentMultiple",
    "displayName": "My test role assignment 1",
    "description": "My role assignment description",
    "roleDefinitionId": "b5c08161-a7af-481c-ace2-a20a69a48fb1",
    "principalIds": ["f8ca5a85-489a-49a0-b555-0a6d81e56f0d", "c1518aa9-4da5-4c84-a902-a31404023890"]
}

响应

下面展示了示例响应。

注意： 为了提高可读性，可能缩短了此处显示的响应对象。所有属性都将通过实际调用返回。

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#roleManagement/cloudPC/roleAssignments/$entity",
    "id": "47c88dcd-cc79-4b0c-ba7d-7af2199649c5",
    "displayName": "My role assignment",
    "description": "My role assignment description",
    "roleDefinitionId": "b5c08161-a7af-481c-ace2-a20a69a48fb1",
    "principalIds": [
        "f8ca5a85-489a-49a0-b555-0a6d81e56f0d",
        "c1518aa9-4da5-4c84-a902-a31404023890"
    ],
    "directoryScopeIds": [
        "/"
    ],
    "appScopeIds": []
}