tipo de recurso administrativeUnit

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, consulte 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.
• Funcionalidades de consulta de OData , como $select, $filter, $searchy $top. Los usos específicos solo se admiten con funcionalidades de consulta avanzadas.

Métodos

Método	Tipo de valor devuelto	Descripción
Crear	administrativeUnit	Cree 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.
Memberships
Agregar 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 miembro	directoryObject	Obtener un miembro específico.
Eliminar miembro	directoryObject	Quitar un miembro.
Asignaciones de roles
Enumeración de asignaciones de roles con ámbito	Colección scopedRoleMembership	Enumera las asignaciones de roles de Microsoft Entra con ámbito de unidad administrativa.
Asignación de un rol con ámbito	scopedRoleMembership	Asigne un rol de Microsoft Entra con ámbito de unidad administrativa.
Obtención de la asignación de roles con ámbito	scopedRoleMembership	Obtenga una asignación de roles de Microsoft Entra con ámbito de unidad administrativa.
Eliminación de la asignación de roles con ámbito	scopedRoleMembership	Quite una asignación de roles de Microsoft Entra con ámbito de unidad administrativa.
Elementos eliminados
Lista	Colección directoryObject	Recupere una lista de unidades administrativas eliminadas recientemente de una colección de objetos de directorio.
Get	directoryObject	Recupere las propiedades de un objeto de unidad administrativa eliminado recientemente.
Restaurar	directoryObject	Restaure un objeto de unidad administrativa eliminado recientemente.

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 valores 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

• Agregar datos personalizados a los recursos mediante extensiones
• Agregar datos personalizados a los usuarios mediante extensiones abiertas
• Agregar datos personalizados a los grupos mediante extensiones de esquema