通过

administrativeUnit 资源类型

  • 项目

命名空间：microsoft.graph

重要

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

管理单元为用户、组和设备目录对象提供概念容器。 借助管理单元，公司管理员现在可以将管理职责委托给区域或部门管理员，以管理包含在管理单元内或范围内的用户、组和设备。 有关管理单元的详细信息，请参阅 Microsoft Entra ID 中的管理单元。

此资源是允许传入其他属性的开放类型。

该资源支持：

  • 将你自己的数据作为扩展添加到自定义属性。
  • 通过提供 delta 函数，使用 delta 查询跟踪增量添加、删除和更新。

方法

方法 返回类型 说明
创建 administrativeUnit Create新的管理单元。
List administrativeUnit 集合 列出所有 administrativeUnits 的属性。
Get administrativeUnit 读取特定 administrativeUnit 对象的属性和关系。
更新 administrativeUnit 更新 administrativeUnit 对象。
删除 无 删除 administrativeUnit 对象。
获取增量 administrativeUnit 获取新创建、更新或删除的 administrativeUnits ，而无需执行整个资源集合的完全读取。
添加成员 directoryObject (用户或组) 添加成员。
List members directoryObject 集合 获取 (用户和组) 成员的列表。
获取成员 directoryObject 获取特定成员。
删除成员 directoryObject 删除成员。
分配具有作用域的角色 scopedRoleMembership 分配具有管理单元范围的Microsoft Entra角色。
列出作用域的角色分配 scopedRoleMembership 集合 列出Microsoft Entra具有管理单元范围的角色分配。
获取具有作用域的角色分配 scopedRoleMembership 获取具有管理单元范围的Microsoft Entra角色分配。
删除具有作用域的角色分配 scopedRoleMembership 删除具有管理单元范围的Microsoft Entra角色分配。
开放扩展
创建开放扩展 openTypeExtension 创建开放扩展，并将自定义属性添加到新资源或现有资源。
获取开放扩展 openTypeExtension 集合 获取扩展名称标识的开放扩展。
架构扩展
添加架构扩展值 创建架构扩展定义，然后使用它向资源添加自定义键入数据。

注意

用于调用 administrativeUnits API 的 URL 终结点位于 /administrativeUnits 终结点中 beta ，但在 /directory/administrativeUnits 终结点中 v1.0 。

属性

重要

仅当使用设置为 eventual 和 $count 的 ConsistencyLevel 标头时，才支持 $filter 和 $search 查询参数的特定用法。 有关详细信息，请参阅 目录对象的高级查询功能。

财产。 类型 说明
说明 String 管理单元的可选说明。 支持 $filter (eq、ne、、 instartsWith) 、 $search。
displayName String 管理单元的显示名称。 支持 $filter（eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq）、$search 和 $orderby。
id String 管理单元的唯一标识符。 此为只读属性。 支持 $filter（eq）。
isMemberManagementRestricted 布尔值 true 如果应将此管理单元的成员视为敏感，则需要特定的权限才能进行管理。 默认值为 false。 使用此属性可定义其角色不继承自租户级管理员的管理单元，并且单个成员对象的管理仅限于限定为受限管理单元的管理员。 不可变，因此以后无法更改。

有关使用受限管理管理单元的详细信息，请参阅 Microsoft Entra ID 中的受限管理管理单元。
membershipRule String 管理单元的动态成员身份规则。 有关可用于动态管理单元和动态组的规则的详细信息，请参阅 使用属性创建高级规则。
membershipRuleProcessingState String 用于控制是否主动处理动态成员身份规则。 On如果希望动态成员身份规则处于活动状态，并且Paused想要停止动态更新成员身份，请将 设置为 。 如果未设置，则默认行为为 Paused。
membershipType String 管理单元的成员身份类型。 可以是 dynamic 或 assigned。 如果未设置，则默认行为为 assigned。
visibility String 控制管理单元及其成员是隐藏的还是公共的。 可以设置为 HiddenMembership 或 Public。 如果未设置，则默认行为为 Public。 设置为 HiddenMembership时，只有管理单元的成员才能列出管理单元的其他成员。

提示

默认情况下返回目录扩展和关联数据，而架构扩展和关联数据仅在 上 $select返回。

关系

关系 类型 说明
extensions 扩展集合 为此管理单元定义的开放扩展的集合。 可为 Null。
members directoryObject collection 属于此管理单元成员的用户和组。 支持 $expand。
scopedRoleMembers scopedRoleMembership 集合 此管理单元的范围角色成员。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "visibility": "String",
  "membershipType": "String",
  "membershipRule": "String",
  "membershipRuleProcessingState": "String"
}

相关内容