unifiedRoleDefinition Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Auflistung der Vorgänge wie Lesen, Schreiben und Löschen dar, die von einem RBAC-Anbieter im Rahmen der Microsoft 365 RBAC-Rollenverwaltung ausgeführt werden können.

Die folgenden RBAC-Anbieter werden derzeit unterstützt:

  • Cloud-PC
  • Geräteverwaltung (Intune)
  • Verzeichnis (Microsoft Entra ID)
  • Berechtigungsverwaltung (Microsoft Entra Berechtigungsverwaltung)
  • Exchange Online:

Methoden

Methode Rückgabetyp Beschreibung
List unifiedRoleDefinition collection Lesen Sie eine Liste der unifiedRoleDefinition-Objekte und deren Eigenschaften.
Create unifiedRoleDefinition Erstellen Sie ein unifiedRoleDefinition-Objekt.
Get unifiedRoleDefinition Lesen Sie die Eigenschaften eines aktiven oder vorläufig gelöschten unifiedRoleDefinition-Objekts.
Update unifiedRoleDefinition Aktualisieren eines unifiedRoleDefinition-Objekts.
Löschen Keine Löschen eines aktiven unifiedRoleDefinition-Objekts oder endgültiges Löschen einer vorläufig gelöschten benutzerdefinierten Rollendefinition.
Wiederherstellen unifiedRoleDefinition Wiederherstellen einer vorläufig gelöschten benutzerdefinierten Rollendefinition.
Zugewiesene Prinzipale auflisten directoryObject collection Rufen Sie die Benutzer und Gruppen ab, die einer Rolle in allen Bereichen zugewiesen sind.

Eigenschaften

Eigenschaft Typ Beschreibung
allowedPrincipalTypes allowedRolePrincipalTypes Typen von Prinzipalen, denen die Rolle zugewiesen werden kann. Schreibgeschützt. Mögliche Werte sind: user, servicePrincipal, group, unknownFutureValue. Dies ist eine mehrwertige Enumeration, die bis zu drei Werte als durch Trennzeichen getrennte Zeichenfolge enthalten kann. Beispiel: user, group. Unterstützt $filter (eq).
deletedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die benutzerdefinierte Rollendefinition gelöscht wurde. Der Wert gilt null für aktive und wiederhergestellte Rollendefinitionen. Schreibgeschützt.
description Zeichenfolge Die Beschreibung für die unifiedRoleDefinition. Schreibgeschützt, wenn isBuiltIn ist true.
displayName Zeichenfolge Der Anzeigename für die unifiedRoleDefinition. Schreibgeschützt, wenn isBuiltIn ist true. Erforderlich. Unterstützt $filter (eq und startsWith).
id Zeichenfolge Der eindeutige Bezeichner für die unifiedRoleDefinition. Schlüssel, nicht NULL-fähig, schreibgeschützt. Unterstützt $filter (eq nur Operator).
isBuiltIn Boolean Flag gibt an, ob die unifiedRoleDefinition Teil des Standardsatzes ist, der im Produkt enthalten oder benutzerdefiniert ist. Schreibgeschützt. Unterstützt $filter (eq).
isEnabled Boolescher Wert Flag, das angibt, ob die Rolle für die Zuweisung aktiviert ist. Bei "false" ist die Rolle nicht zur Zuweisung verfügbar. Schreibgeschützt, wenn isBuiltIn ist true.
isPrivileged Boolean Flag, das angibt, ob die Rolle privilegiert ist. Microsoft Entra ID definiert eine Rolle als privilegiert, wenn sie mindestens eine sensible Ressourcenaktion in den rolePermissions- und allowedResourceActions-Objekten enthält. Gilt nur für Aktionen im microsoft.directory Ressourcennamespace. Schreibgeschützt. Unterstützt $filter (eq).
resourceScopes String collection Liste der Bereiche, für die von der Rollendefinition gewährte Berechtigungen gelten. Derzeit wird nur / unterstützt. Schreibgeschützt, wenn isBuiltIn ist true. NICHT VERWENDEN. Dies wird bald veraltet sein. Bereich an Rollenzuweisung anfügen.
rolePermissions unifiedRolePermission-Auflistung Liste der Berechtigungen, die in der Rolle enthalten sind. Schreibgeschützt, wenn isBuiltIn ist true. Erforderlich.
templateId Zeichenfolge Benutzerdefinierte Vorlagen-ID, die festgelegt werden kann, wenn isBuiltIn ist false. Dieser Bezeichner wird normalerweise verwendet, wenn ein Bezeichner in verschiedenen Verzeichnissen identisch sein muss. Schreibgeschützt, wenn isBuiltIn ist true.
Version Zeichenfolge Gibt die Version des unifiedRoleDefinition-Objekts an. Schreibgeschützt, wenn isBuiltIn ist true.

Beziehungen

Beziehung Typ Beschreibung
inheritsPermissionsFrom unifiedRoleDefinition collection Schreibgeschützte Auflistung von Rollendefinitionen, von denen die angegebene Rollendefinition erbt. Nur die integrierten Rollen von Microsoft Entra unterstützen dieses Attribut.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "allowedPrincipalTypes": "String",
  "deletedDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "isBuiltIn": true,
  "isEnabled": true,
  "isPrivileged": true,
  "resourceScopes": ["String"],
  "rolePermissions": [{"@odata.type": "microsoft.graph.unifiedRolePermission"}],
  "templateId": "String",
  "inheritsPermissionsFrom": [{"@odata.type": "microsoft.graph.unifiedRoleDefinition"}],
  "version": "String"
}
  • Zuletzt aktualisiert um