tipo de recurso administrativeUnitadministrativeUnit resource type

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported. Para determinar si una API está disponible en v1.0, usa el selector de versiones.To determine whether an API is available in v1.0, use the Version selector.

Una unidad administrativa proporciona un contenedor conceptual para objetos de directorio de usuario y grupo.An administrative unit provides a conceptual container for User and Group directory objects. Con las unidades administrativas, un administrador de la compañía ahora puede delegar responsabilidades administrativas para administrar los usuarios y grupos contenidos en una unidad administrativa o con ámbito en una unidad administrativa a un administrador regional o departamental.Using administrative units, a company administrator can now delegate administrative responsibilities to manage the users and groups contained within or scoped to an administrative unit to a regional or departmental administrator.

Este recurso es compatible con el uso de una consulta delta para realizar un seguimiento de las adiciones incrementales, las eliminaciones y las actualizaciones proporcionando una función delta.This resource supports using delta query to track incremental additions, deletions, and updates, by providing a delta function.

Veamos un ejemplo.Let's look at an example. Imagine que Contoso Corp está hecho de dos divisiones: una división de la costa oeste y una división de la costa este.Imagine that Contoso Corp is made up of two divisions - a West Coast Division and an East Coast Division. Los roles de directorio de Contoso están en el ámbito de todo el espacio empresarial.Directory roles at Contoso are scoped to the entire tenant. Lee, un administrador de la compañía Contoso, quiere delegar responsabilidades administrativas, pero las atribuyó a la División de la Costa Oeste o a la división de la Costa Este.Lee, a Contoso company administrator, wants to delegate administrative responsibilities, but scope them to the West Coast Division or the East Coast division. Lee puede crear una unidad admistrativa de la Costa Oeste y colocar a todos los usuarios de la Costa Oeste en esta unidad administrativa.Lee can create a West Coast admistrative unit and place all West Coast users into this administrative unit. Del mismo modo, Lee puede crear una unidad administrativa de la costa este.Similarly, Lee can create an East Coast adminstrative unit. Ahora Lee puede empezar a delegar responsabilidades administrativas a otras personas, pero en el ámbito de las nuevas unidades administrativas que ha creado. Now Lee, can start delegating administrative responsibilities to others, but scoped to the new administrative units he's created. Lee coloca a Jennifer en un rol de administrador del departamento de soporte técnico en el ámbito de la unidad administrativa de la costa oeste.Lee places Jennifer in a helpdesk administrator role scoped to the West Coast administrative unit. Esto permite a Jennifer restablecer la contraseña de cualquier usuario, pero solo si esos usuarios se encuentran en la unidad administrativa de la costa oeste .This allows Jennifer to reset any user's password, but only if those users are in the West Coast administrative unit. Del mismo modo, Lee coloca a Dave en un rol de administrador de cuenta de usuario con el ámbito de la unidad administrativa de la costa este.Similarly, Lee places Dave in a user account administrator role scoped to the East Coast administrative unit. Esto permite a Dave actualizar usuarios, asignar licencias y restablecer la contraseña de cualquier usuario, pero solo si esos usuarios se encuentran en la unidad administrativa de la costa este.This allows Dave to update users, assign licenses and reset any user's password, but only if those users are in the East Coast administrative unit. Para obtener información general sobre el vídeo, consulte Introducción a las unidades administrativas de Azure Active Directory.For a video overview, please see Introduction to Azure Active Directory Administrative Units.

Este recurso le permite agregar sus propios datos a las propiedades personalizadas mediante extensiones.This resource lets you add your own data to custom properties using extensions.

En este tema se proporcionan descripciones de las propiedades declaradas y las propiedades de navegación expuestas por la entidad administrativeUnit, así como las operaciones y funciones a las que se puede llamar en el recurso administrativeUnits.This topic provides descriptions of the declared properties and navigation properties exposed by the administrativeUnit entity, as well as the operations and functions that can be called on the administrativeUnits resource.

MethodsMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
CrearCreate administrativeUnitadministrativeUnit Cree una nueva unidad administrativa.Create a new administrative unit.
ListaList colección administrativeUnitadministrativeUnit collection Enumerar las propiedades de todas las administrativeUnits.List properties of all administrativeUnits.
ObtenerGet administrativeUnitadministrativeUnit Lea las propiedades y las relaciones de un objeto administrativeUnit específico.Read properties and relationships of a specific administrativeUnit object.
ActualizaciónUpdate administrativeUnitadministrativeUnit Actualizar el objeto administrativeUnit.Update administrativeUnit object.
EliminarDelete NingunoNone Elimine el objeto administrativeUnit.Delete administrativeUnit object.
Obtener deltaGet delta administrativeUnitadministrativeUnit Obtenga administrativeUnits recién creados, actualizados o eliminados sin tener que realizar una lectura completa de toda la colección de recursos.Get newly created, updated, or deleted administrativeUnits without having to perform a full read of the entire resource collection.
Agregar un miembroAdd a member directoryObjectdirectoryObject Agregar un miembro (usuario o grupo).Add a member (user or group).
Enumerar los miembrosList members Colección directoryObjectdirectoryObject collection Obtener la lista de miembros (usuario y grupo).Get the list of (user and group) members.
Obtener un miembroGet a member directoryObjectdirectoryObject Obtener un miembro específico.Get a specific member.
Quitar un miembroRemove a member directoryObjectdirectoryObject Quitar un miembro.Remove a member.
Agregar miembro de rol con ámbitoAdd scoped-role member scopedRoleMembershipscopedRoleMembership Agregue un miembro de rol con ámbito.Add a scoped-role member.
Enumerar miembros de roles con ámbitoList scoped-role members Colección scopedRoleMembershipscopedRoleMembership collection Obtener la lista de administradores de roles con ámbito.Get the list of scoped-role administrators.
Obtener un miembro de rol con ámbitoGet a scoped-role member scopedRoleMembershipscopedRoleMembership Obtener un miembro de rol con ámbito específico.Get a specific scoped-role member.
Quitar un miembro de rol con ámbitoRemove a scoped-role member scopedRoleMembershipscopedRoleMembership Quitar un miembro de rol con ámbito.Remove a scoped-role member.
Extensiones abiertasOpen extensions
Crear extensión abiertaCreate open extension openTypeExtensionopenTypeExtension Crea una extensión abierta y agrega propiedades personalizadas en una instancia nueva o un recurso existente.Create an open extension and add custom properties to a new or existing resource.
Obtener extensión abiertaGet open extension Colección openTypeExtensionopenTypeExtension collection Obtiene una extensión abierta identificada por el nombre de extensión.Get an open extension identified by the extension name.
Extensiones de esquemaSchema extensions
Agregar valores de extensión de esquemaAdd schema extension values Cree una definición de extensión de esquema y, después, úsela para agregar datos escritos personalizados a un recurso.Create a schema extension definition and then use it to add custom typed data to a resource.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
descriptiondescription stringstring Una descripción opcional para la unidad administrativa.An optional description for the administrative unit.
displayNamedisplayName stringstring Nombre para mostrar de la unidad administrativa.Display name for the administrative unit.
idid stringstring Identificador único de la unidad administrativa.Unique identifier for the administrative unit. Solo lectura.Read-only.
visibilityvisibility stringstring Controla si la unidad administrativa y sus miembros están ocultos o públicos.Controls whether the administrative unit and its members are hidden or public. Se puede establecer en HiddenMembership o Public .Can be set to HiddenMembership or Public. Si no se establece, el comportamiento predeterminado es Public .If not set, default behavior is Public. Cuando se establece en HiddenMembership , solo los miembros de la unidad administrativa pueden enumerar otros miembros de la unidad administrativa.When set to HiddenMembership, only members of the administrative unit can list other members of the administrative unit.

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
extensionsextensions Colección Extensionextension collection Colección de extensiones abiertas definidas para esta unidad administrativa.The collection of open extensions defined for this Administrative Unit. Admite valores NULL.Nullable.
membersmembers Colección directoryObjectdirectoryObject collection Usuarios y grupos que son miembros de esta unidad adminsitrativa.Users and groups that are members of this Adminsitrative Unit. Métodos HTTP: GET (miembros de lista), POST (agregar miembros), DELETE (quitar miembros).HTTP Methods: GET (list members), POST (add members), DELETE (remove members).
scopedRoleMembersscopedRoleMembers Colección scopedRoleMembershipscopedRoleMembership collection Miembros de roles con ámbito de esta unidad administrativa.Scoped-role members of this Administrative Unit. Métodos HTTP: GET (list scopedRoleMemberships), POST (add scopedRoleMembership), DELETE (remove scopedRoleMembership).HTTP Methods: GET (list scopedRoleMemberships), POST (add scopedRoleMembership), DELETE (remove scopedRoleMembership).

Representación JSONJSON representation

Aquí tiene una representación JSON del recurso.Here is a JSON representation of the resource.

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

Consulte tambiénSee also