Ressourcentyp directoryRoleTemplate

Namespace: microsoft.graph

Hinweis

Microsoft empfiehlt, anstelle dieser API die einheitliche RBAC-API zu verwenden. Die einheitliche RBAC-API bietet mehr Funktionalität und Flexibilität. Weitere Informationen finden Sie unter unifiedRoleDefinition-Ressourcentyp.

Stellt eine Verzeichnisrollenvorlage dar. Eine Verzeichnisrollenvorlage gibt die Eigenschaftswerte einer Verzeichnisrolle DirectoryRole an. Es gibt ein zugeordnetes Verzeichnisrollenvorlagenobjekt für jede Verzeichnisrolle, die in einem Mandanten aktiviert werden kann. Um eine Verzeichnisrolle zu lesen oder ihre Mitglieder zu aktualisieren, muss diese zuerst im Mandanten aktiviert werden. Nur die Unternehmensadministratoren sind standardmäßig aktiviert. Um andere verfügbare Verzeichnisrollen zu aktivieren, senden Sie eine POST-Anforderung an den /directoryRoles Endpunkt mit der ID der Verzeichnisrollenvorlage, auf der die Verzeichnisrolle basiert, die im roleTemplateId-Parameter der Anforderung angegeben ist. Nach dem erfolgreichen Abschluss dieser Anforderung können Sie die Verzeichnisrolle lesen und ihr Mitglieder zuweisen. Hinweis: Eine Verzeichnisrollenvorlage wird für die Verzeichnisrolle der Benutzer verfügbar gemacht. Die Verzeichnisrolle Benutzer ist implizit und für Verzeichnisclients nicht sichtbar. Jeder Benutzer im Mandanten wird von der Infrastruktur dieser Rolle zugewiesen. Die Rolle ist bereits aktiviert. Verwenden Sie diese Vorlage nicht.

Methoden

Methode	Rückgabetyp	Beschreibung
Get	directoryRoleTemplate	Dient zum Lesen der Eigenschaften und der Beziehungen des directoryRoleTemplate-Objekts.
List	directoryRoleTemplate-Sammlung	Dient zum Abrufen einer Liste von directoryRoleTemplate-Objekten.

Eigenschaften

Eigenschaft	Typ	Beschreibung
description	String	Die festzulegende Beschreibung für die Verzeichnisrolle. Schreibgeschützt.
displayName	String	Der festzulegende Name für die Verzeichnisrolle. Schreibgeschützt.
id	String	Der eindeutige Bezeichner für die Vorlage. Geerbt von directoryObject. Sie geben die id der Verzeichnisrollenvorlage die Eigenschaft RoleTemplateId in der POST-Anforderung zum Aktivieren einer DirectoryRole in einen Mandanten an. Schlüssel, lässt keine Nullwerte zu. Schreibgeschützt.

Beziehungen

Keine

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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