Compartir a través de

tipo de recurso administrativeUnit

  • Artículo

Espacio de nombres: microsoft.graph

Una unidad administrativa proporciona un contenedor conceptual para los objetos de directorio de usuario, grupo y dispositivo. Con las unidades administrativas, un administrador de la empresa ahora puede delegar responsabilidades administrativas para administrar los usuarios, grupos y dispositivos contenidos en una unidad administrativa o en el ámbito de ella a un administrador regional o departamental. Para obtener más información sobre las unidades administrativas, vea Unidades administrativas en Microsoft Entra ID.

Este recurso es de tipo abierto y permite que pasen otras propiedades.

Este recurso admite:

  • que agregue sus propios datos a las propiedades personalizadas como extensiones.
  • El uso de una consulta delta para realizar un seguimiento de adiciones, eliminaciones y actualizaciones incrementales al proporcionar una función delta.

Métodos

Método Tipo de valor devuelto Descripción
Crear administrativeUnit Create una nueva unidad administrativa.
Lista colección administrativeUnit Enumera las propiedades de todas las unidades administrativas.
Get administrativeUnit Lea las propiedades y las relaciones de un objeto administrativeUnit específico.
Actualizar administrativeUnit Actualice el objeto administrativeUnit.
Delete Ninguno Elimine el objeto administrativeUnit.
Agregar un miembro directoryObject Agregue un miembro (usuario, grupo o dispositivo).
Enumerar los miembros Colección directoryObject Obtenga la lista de miembros (usuario, grupo o dispositivo).
Obtener un miembro directoryObject Obtener un miembro específico.
Quitar un miembro directoryObject Quitar un miembro.
Asignación de un rol con ámbito scopedRoleMembership Asigne un rol de Microsoft Entra con ámbito de unidad administrativa.
Enumeración de asignaciones de roles con ámbito Colección scopedRoleMembership Enumere Microsoft Entra asignaciones de roles con ámbito de unidad administrativa.
Obtención de una asignación de roles con ámbito scopedRoleMembership Obtenga una asignación de roles Microsoft Entra con ámbito de unidad administrativa.
Eliminación de una asignación de roles con ámbito scopedRoleMembership Quite una asignación de roles Microsoft Entra con ámbito de unidad administrativa.

Propiedades

Importante

El uso específico de $filter y el parámetro de consulta $search solo se admite cuando se usa el encabezado ConsistencyLevel establecido en eventual y $count. Para obtener más información, vea Funcionalidades avanzadas de consulta en objetos de directorio.

Propiedad Tipo Descripción
description Cadena Descripción opcional de la unidad administrativa. Admite $filter (eq, ne, in, startsWith), $search.
displayName Cadena Nombre para mostrar de la unidad administrativa. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null), $search y $orderby.
id Cadena Identificador único de la unidad administrativa. Solo lectura. Admite $filter (eq).
visibility Cadena Controla si la unidad administrativa y sus miembros están ocultos o son públicos. Se puede establecer en HiddenMembership. Si no se establece (el valor es null), el comportamiento predeterminado es público. Cuando se establece en HiddenMembership, solo los miembros de la unidad administrativa pueden enumerar otros miembros de la unidad administrativa.

Sugerencia

Las extensiones de directorio y los datos asociados se devuelven de forma predeterminada, mientras que las extensiones de esquema y los datos asociados solo se devuelven en $select.

Relaciones

Relación Tipo Descripción
members Colección directoryObject Usuarios y grupos que son miembros de esta unidad administrativa. Admite $expand.
extensions Colección Extension Colección de extensiones abiertas definidas para esta unidad administrativa. Admite un valor NULL.
scopedRoleMembers Colección scopedRoleMembership Miembros de rol con ámbito de esta unidad administrativa.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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

Contenido relacionado