administrativeUnit-Ressourcentyp
Namespace: microsoft.graph
Eine Verwaltungseinheit stellt einen konzeptionellen Container für Benutzer-, Gruppen- und Geräteverzeichnisobjekte bereit. Mit Verwaltungseinheiten kann ein Unternehmensadministrator jetzt administrative Zuständigkeiten zum Verwalten der Benutzer, Gruppen und Geräte, die in einer Verwaltungseinheit enthalten sind oder auf eine Verwaltungseinheit beschränkt sind, an einen regionalen administrator oder abteilungsbezogenen Administrator delegieren. Weitere Informationen zu Verwaltungseinheiten finden Sie unter Administrative Einheiten in Microsoft Entra ID.
Diese Ressource ist ein offener Typ, mit dem andere Eigenschaften übergeben werden können.
Diese Ressource unterstützt Folgendes:
- Hinzufügen Ihrer eigenen Daten zu benutzerdefinierten Eigenschaften als Erweiterungen.
- Verwenden einer Delta-Abfrage zum Nachverfolgen von inkrementellen Hinzufügungen, Löschungen und Aktualisierungen durch Bereitstellen der delta-Funktion.
-
OData-Abfragefunktionen , einschließlich
$select,$filter,$searchund$top. Bestimmte Verwendungen werden nur mit erweiterten Abfragefunktionen unterstützt.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Create | administrativeUnit | Erstellen Sie eine neue Verwaltungseinheit. |
| List | administrativeUnit-Sammlung | Listet die Eigenschaften aller administrativeUnits auf. |
| Get | administrativeUnit | Liest Eigenschaften und Beziehungen eines bestimmten administrativeUnit-Objekts. |
| Update | administrativeUnit | Aktualisieren Sie das administrativeUnit-Objekt. |
| Löschen | Keine | Löschen Sie das administrativeUnit-Objekt. |
| Memberships | ||
| Mitglied hinzufügen | directoryObject | Fügen Sie ein Mitglied (Benutzer, Gruppe oder Gerät) hinzu. |
| Mitglieder auflisten | directoryObject-Sammlung | Ruft die Liste der Mitglieder (Benutzer, Gruppe oder Gerät) ab. |
| Mitglied abrufen | directoryObject | Ruft ein bestimmtes Element ab. |
| Mitglied entfernen | directoryObject | Entfernen sie ein Mitglied. |
| Rollenzuweisungen | ||
| Auflisten von Rollenzuweisungen mit Bereich | scopedRoleMembership-Sammlung | Auflisten Microsoft Entra Rollenzuweisungen mit Verwaltungseinheitsbereich. |
| Zuweisen einer Rolle mit Bereich | scopedRoleMembership | Weisen Sie eine Microsoft Entra Rolle mit Verwaltungseinheitsbereich zu. |
| Abrufen der Rollenzuweisung mit Bereich | scopedRoleMembership | Rufen Sie eine Microsoft Entra Rollenzuweisung mit Verwaltungseinheitsbereich ab. |
| Entfernen der Rollenzuweisung mit Bereich | scopedRoleMembership | Entfernen Sie eine Microsoft Entra Rollenzuweisung mit Verwaltungseinheitsbereich. |
| Gelöschte Elemente | ||
| List | directoryObject collection | Rufen Sie eine Liste der zuletzt gelöschten Verwaltungseinheiten aus einer Auflistung von Verzeichnisobjekten ab. |
| Get | directoryObject | Ruft die Eigenschaften eines kürzlich gelöschten Verwaltungseinheitsobjekts ab. |
| Wiederherstellen | directoryObject | Stellen Sie ein kürzlich gelöschtes Verwaltungseinheitsobjekt wieder her. |
Eigenschaften
Wichtig
Die spezifische Verwendung von $filter und des Abfrageparameters $search wird nur unterstützt, wenn Sie die Kopfzeile ConsistencyLevel verwenden, die auf eventual und $count festgelegt ist. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Verzeichnisobjekte.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| description | Zeichenfolge | Eine optionale Beschreibung für die Verwaltungseinheit. Unterstützt $filter (eq, ne, in, startsWith), $search. |
| displayName | Zeichenfolge | Anzeigename für die Verwaltungseinheit. Die maximale Länge beträgt 256 Zeichen. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte), $search und $orderby. |
| id | Zeichenfolge | Eindeutiger Bezeichner für die Verwaltungseinheit. Schreibgeschützt. Unterstützt $filter (eq). |
| membershipRule | Zeichenfolge | Die Dynamische Mitgliedschaftsregel für die Verwaltungseinheit. Weitere Informationen zu den Regeln, die Sie für dynamische Verwaltungseinheiten und dynamische Gruppen verwenden können, finden Sie unter Verwalten von Regeln für dynamische Mitgliedschaftsgruppen in Microsoft Entra ID. |
| membershipRuleProcessingState | Zeichenfolge | Steuert, ob die dynamische Mitgliedschaftsregel aktiv verarbeitet wird. Legen Sie diesen Wert auf On fest, um die Dynamische Mitgliedschaftsregel zu aktivieren oder Paused die dynamische Aktualisierung der Mitgliedschaft zu beenden. |
| membershipType | Zeichenfolge | Gibt den Mitgliedschaftstyp für die Verwaltungseinheit an. Die möglichen Werte sind: dynamic, assigned. Wenn nicht festgelegt, ist null der Standardwert, und das Standardverhalten wird zugewiesen. |
| visibility | Zeichenfolge | Steuert, ob die Verwaltungseinheit und ihre Mitglieder ausgeblendet oder öffentlich sind. Kann auf HiddenMembershipfestgelegt werden. Wenn nicht festgelegt, lautet null der Standardwert, und das Standardverhalten ist öffentlich. Bei Festlegung auf HiddenMembershipkönnen nur Mitglieder der Verwaltungseinheit andere Mitglieder der Verwaltungseinheit auflisten. |
Tipp
Verzeichniserweiterungen und zugeordnete Daten werden standardmäßig zurückgegeben, während Schemaerweiterungen und zugehörige Daten nur auf $selectzurückgegeben werden.
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Elemente | directoryObject collection | Benutzer und Gruppen, die Mitglieder dieser Verwaltungseinheit sind. Unterstützt $expand. |
| Erweiterungen | extension-Sammlung | Die Sammlung von offenen Erweiterungen, die für diese Verwaltungseinheit definiert sind. Nullwerte zulassend. |
| scopedRoleMembers | scopedRoleMembership-Sammlung | Bereichsbezogene Rollenmitglieder dieser Verwaltungseinheit. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"description": "String",
"displayName": "String",
"id": "String (identifier)",
"membershipRule": "String",
"membershipRuleProcessingState": "String",
"membershipType": "String",
"visibility": "String"
}