Ressourcentyp administrativeUnitadministrativeUnit resource type

Wichtig: Die APIs der /Beta-Version in Microsoft Graph befinden sich in der Vorschau und können Änderungen unterliegen.Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Eine administrative Einheit enthält einen konzeptionellen Container für Benutzer- und Verzeichnisobjekte.An administrative unit provides a conceptual container for User and Group directory objects. Verwenden von administrativen Einheiten, ein Unternehmensadministrator delegieren kann jetzt administrative Aufgaben zum Verwalten von Benutzern und Gruppen innerhalb oder auf eine administrative Einheit an einen Administrator regionalen oder auf Abteilungsebene bereichsbezogenen.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.

Sehen wir uns ein Beispiel.Let's look at an example. Angenommen Sie, Contoso Corp aus zwei Abschnitte - Division Süd und eine Division Nord besteht.Imagine that Contoso Corp is made up of two divisions - a West Coast Division and an East Coast Division. Verzeichnis Rollen bei Contoso sind auf den gesamten Mandanten beschränkt.Directory roles at Contoso are scoped to the entire tenant. Kelly, ein Administrator von Contoso Unternehmen, möchte Verwaltungsaufgaben delegieren, aber die Division Süd oder die Division Nord festlegen.Lee, a Contoso company administrator, wants to delegate administrative responsibilities, but scope them to the West Coast Division or the East Coast division. Kelly kann Süd Admistrative Einheit erstellen und alle Süd Benutzer in dieser administrative Einheit platzieren.Lee can create a West Coast admistrative unit and place all West Coast users into this administrative unit. Ebenso kann Kelly eine Nord administrative Einheiterstellen.Similarly, Lee can create an East Coast adminstrative unit. Nun können Kelly, starten Sie Delegieren von Verwaltungsaufgaben an andere Personen, aber in die neuen administrativen Einheiten bezogenen er erstellt wird.Now Lee, can start delegating administrative responsibilities to others, but scoped to the new administrative units he's created. Kelly platziert zur Verfügung, in eine Helpdeskadministrator Rolle als Bereich der Süd administrative Einheit.Lee places Jennifer in a helpdesk administrator role scoped to the West Coast administrative unit. Dadurch wird zur Verfügung Kennwort des Benutzers, aber nur, wenn diese Benutzer in der Süd administrative Einheitsind zurücksetzen.This allows Jennifer to reset any user's password, but only if those users are in the West Coast administrative unit. In ähnlicher Weise platziert Kelly Dave in einen Benutzer Kontoadministrator Rolle bezogenen zur Nord administrative Einheit.Similarly, Lee places Dave in a user account administrator role scoped to the East Coast administrative unit. Dadurch können Benutzer aktualisieren, Zuweisen von Lizenzen und Zurücksetzen des Kennworts des Benutzers, aber nur, wenn die Benutzer in der Nord administrative Einheit sindDave.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. Video mit einer Übersicht finden Sie unter Einführung in Azure Active Directory Administrative Einheiten.For a video overview, please see Introduction to Azure Active Directory Administrative Units.

Diese Ressource ermöglicht es Ihnen, benutzerdefinierten Eigenschaften mithilfe von Erweiterungen eigene Daten hinzuzufügen.This resource lets you add your own data to custom properties using extensions.

Dieses Thema enthält eine Beschreibung der deklarierte Eigenschaften und Navigationseigenschaften verfügbar gemacht werden, durch die AdministrativeUnit-Entität als auch die Vorgänge und Funktionen, die für die Ressource AdministrativeUnits aufgerufen werden können.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.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Erstellen von administrativeUnitCreate administrativeUnit administrativeUnitadministrativeUnit Erstellen Sie eine neue administrative Einheit.Create a new administrative unit.
Liste administrativeUnitsList administrativeUnits AdministrativeUnit -AuflistungadministrativeUnit collection Aller AdministrativeUnits-Listeneigenschaften.List properties of all administrativeUnits.
AdministrativeUnit abrufenGet administrativeUnit administrativeUnitadministrativeUnit Lesen Sie Eigenschaften und die Beziehungen eines bestimmten AdministrativeUnit-Objekts.Read properties and relationships of a specific administrativeUnit object.
AdminstrativeUnit aktualisierenUpdate adminstrativeUnit administrativeUnitadministrativeUnit AdministrativeUnit-Objekt zu aktualisieren.Update administrativeUnit object.
AdminstrativeUnit löschenDelete adminstrativeUnit KeineNone AdministrativeUnit-Objekt zu löschen.Delete administrativeUnit object.
Ein Mitglied hinzufügenAdd a member directoryObjectdirectoryObject Fügen Sie ein Mitglied (Benutzer oder Gruppe).Add a member (user or group).
Mitglieder auflistenList members directoryObject-SammlungdirectoryObject collection Rufen Sie die Liste der Elemente (Benutzer und Gruppen).Get the list of (user and group) members.
Abrufen eines ElementsGet a member directoryObjectdirectoryObject Rufen Sie ein bestimmtes Element.Get a specific member.
Mitglied entfernenRemove a member directoryObjectdirectoryObject Entfernen eines Mitglieds.Remove a member.
Gültigkeitsbereich der Rolle hinzufügenAdd scoped-role member scopedRoleMembershipscopedRoleMembership Fügen Sie ein Mitglied einer bezogenen-Rolle hinzu.Add a scoped-role member.
Mitglieder der Liste bezogenen-RolleList scoped-role members scopedRoleMembership-SammlungscopedRoleMembership collection Rufen Sie die Liste der Administratoren bezogenen-Rolle.Get the list of scoped-role adminstrators.
Ein Mitglied einer bezogenen Rolle abrufenGet a scoped-role member scopedRoleMembershipscopedRoleMembership Rufen Sie ein bestimmtes Element bezogenen-Rolle.Get a specific scoped-role member.
Entfernen eines Mitglieds bezogenen-RolleRemove a scoped-role member scopedRoleMembershipscopedRoleMembership Entfernen Sie ein Mitglied einer bezogenen-Rolle.Remove a scoped-role member.
Offene ErweiterungenOpen extensions
Offene Erweiterung erstellenCreate open extension openTypeExtensionopenTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften zu einer neuen oder vorhandenen Ressource hinzu.Create an open extension and add custom properties to a new or existing resource.
Offene Erweiterung abrufenGet open extension openTypeExtension-SammlungopenTypeExtension collection Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird.Get an open extension identified by the extension name.
SchemaerweiterungenSchema extensions
Schemaerweiterungswerte hinzufügenAdd schema extension values Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.Create a schema extension definition and then use it to add custom typed data to a resource.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
descriptiondescription stringstring Eine optionale Beschreibung für die administrative Einheit.An optional description for the administrative unit.
displayNamedisplayName stringstring Der Anzeigename für die administrative Einheit.Display name for the administrative unit.
idid stringstring Eindeutiger Bezeichner für die administrative Einheit.Unique identifier for the administrative unit. Schreibgeschützt.Read-only.
visibilityvisibility stringstring Steuert, ob die administrative Einheit und seine Member ausgeblendet sind oder öffentlich.Controls whether the adminstrative unit and its members are hidden or public. Kann auf HiddenMembership oder öffentlichen festgelegt werden.Can be set to HiddenMembership or Public. Wenn nicht festgelegt, Standardverhalten öffentlich.If not set, default behavior is Public. Bei Festlegung auf HiddenMembership, können nur Mitglieder der administrative Einheit andere Mitglieder der administrative Einheit anbieten.When set to HiddenMembership, only members of the administrative unit can list other members of the adminstrative unit.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
Erweiterungenextensions extension-Sammlungextension collection Die Auflistung der open-Erweiterungen für diese Administrative Einheit definiert.The collection of open extensions defined for this Administrative Unit. Lässt Nullwerte zu.Nullable.
Elementemembers directoryObject-SammlungdirectoryObject collection Benutzer und Gruppen, die Mitglieder dieser Adminsitrative Einheit sind.Users and groups that are members of this Adminsitrative Unit. HTTP-Methoden: Abrufen (Listenmitglieder) POST (Hinzufügen von Mitgliedern), DELETE (Entfernen von Mitgliedern).HTTP Methods: GET (list members), POST (add members), DELETE (remove members).
scopedRoleMembersscopedRoleMembers scopedRoleMembership-SammlungscopedRoleMembership collection Bezogenen Rolle Mitglieder dieser Administrative Einheit.Scoped-role members of this Administrative Unit. HTTP-Methoden: Abrufen (Liste ScopedRoleMemberships), POST (ScopedRoleMembership hinzufügen), DELETE (Remove ScopedRoleMembership).HTTP Methods: GET (list scopedRoleMemberships), POST (add scopedRoleMembership), DELETE (remove scopedRoleMembership).

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

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

Weitere ArtikelSee also