Ressourcentyp directoryRoleTemplatedirectoryRoleTemplate resource type

Stellt eine Verzeichnisrollenvorlage dar. Eine Verzeichnisrollenvorlage gibt die Eigenschaftswerte einer Verzeichnisrolle DirectoryRole an. Für jede Verzeichnisrolle, die in einem Mandanten aktiviert werden kann, gibt es eine zugehörige Verzeichnisrollenvorlage. Um eine Verzeichnisrolle zu lesen oder ihre Mitglieder zu aktualisieren, muss diese zuerst im Mandanten aktiviert werden. Nur die Unternehmensadministratoren sind standardmäßig aktiviert. Zur Aktivierung anderer verfügbarer Verzeichnisrollen senden Sie eine POST-Anforderung an den /directoryRoles-Endpunkt mit der ID der Verzeichnisrollenvorlage, auf der die Verzeichnisrolle basiert, die im Parameter RoleTemplateId der Anfrage 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 Benutzer-Verzeichnisrolle ist implizit und für Verzeichnis-Clients nicht sichtbar. Jeder Benutzer im Mandanten wird von der Infrastruktur dieser Rolle zugewiesen. Die Rolle ist bereits aktiviert. Verwenden Sie diese Vorlage nicht.Represents a directory role template. A directory role template specifies the property values of a directory role (directoryRole). There is an associated directory role template object for each of the directory roles that may be activated in a tenant. To read a directory role or update its members, it must first be activated in the tenant. Only the Company Administrators directory role is activated by default. To activate other available directory roles you send a POST request to the /directoryRoles endpoint with the ID of the directory role template on which the directory role is based specified in the roleTemplateId parameter of the request. Upon successful completion of this request, you can then start to read and assign members to the directory role. Note: A directory role template is exposed for the Users directory role. The Users directory role is implicit and is not visible to directory clients. Every User in the tenant is assigned to this role by the infrastructure. The role is already activated. Do not use this template.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
directoryRoleTemplate abrufenGet directoryRoleTemplate directoryRoleTemplatedirectoryRoleTemplate Dient zum Lesen der Eigenschaften und der Beziehungen des directoryRoleTemplate-Objekts.Read properties and relationships of directoryRoleTemplate object.
directoryRoleTemplate auflistenList directoryRoleTemplate directoryRoleTemplate-SammlungdirectoryRoleTemplate collection Dient zum Abrufen einer Liste von directoryRoleTemplate-Objekten.Retrieve a list of directoryRoleTemplate objects.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
descriptiondescription StringString Die festzulegende Beschreibung für die Verzeichnisrolle. Schreibgeschützt.The description to set for the directory role. Read-only.
displayNamedisplayName StringString Der festzulegende Name für die Verzeichnisrolle. Schreibgeschützt.The display name to set for the directory role. Read-only.
idid ZeichenfolgeString 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.The unique identifier for the template. Inherited from directoryObject. You specify the id of the directory role template for the roleTemplateId property in the POST request activate a directoryRole in a tenant. Key, Not nullable. Read-only.

BeziehungenRelationships

KeineNone

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)"
}