Verzeichnisrollenmitglied hinzufügen
Namespace: microsoft.graph
Erstellen Sie ein neues Verzeichnisrollenmitglied.
Sie können sowohl die Objekt-ID als auch die Vorlagen-ID von directoryRole mit dieser API verwenden. Die Vorlagen-ID einer integrierten Rolle ist unveränderlich und kann in der Rollenbeschreibung auf dem Microsoft Entra Admin Center angezeigt werden. Weitere Informationen finden Sie unter Rollenvorlagen-IDs.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | RoleManagement.ReadWrite.Directory | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | RoleManagement.ReadWrite.Directory | Nicht verfügbar. |
HTTP-Anforderung
POST /directoryRoles/{role-id}/members/$ref
POST /directoryRoles/roleTemplateId={roleTemplateId}/members/$ref
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung eines directoryObject- oder user-Objekts an, das hinzugefügt werden soll.
Antwort
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content
zurückgegeben.
Beispiele
Beispiel 1: Hinzufügen eines neuen Mitglieds zu einer Verzeichnisrolle mithilfe der Rollen-ID
Ersetzen Sie fe8f10bf-c9c2-47eb-95cb-c26cc85f1830
in dieser Anforderung durch den ID-Wert für die Verzeichnisrolle, die Sie dem Benutzer- oder Verzeichnisobjekt zuweisen möchten. Ersetzen Sie durch 15c1a2d5-9101-44b2-83ab-885db8a647ca
den ID-Wert Ihres Benutzer- oder Verzeichnisobjekts.
Anforderung
POST https://graph.microsoft.com/v1.0/directoryRoles/fe8f10bf-c9c2-47eb-95cb-c26cc85f1830/members/$ref
Content-type: application/json
{
"@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/15c1a2d5-9101-44b2-83ab-885db8a647ca"
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 204 No Content
Content-type: text/plain
Beispiel 2: Hinzufügen eines neuen Mitglieds zu einer Verzeichnisrolle mithilfe von roleTemplateId
Ersetzen Sie 88d8e3e3-8f55-4a1e-953a-9b9898b8876b
in dieser Anforderung durch den Wert von roleTemplateId für die Verzeichnisrolle, die Sie dem Benutzer- oder Verzeichnisobjekt zuweisen möchten. Ersetzen Sie durch bb165b45-151c-4cf6-9911-cd7188912848
den ID-Wert Ihres Benutzer- oder Verzeichnisobjekts.
Anforderung
POST https://graph.microsoft.com/v1.0/directoryRoles/roleTemplateId=88d8e3e3-8f55-4a1e-953a-9b9898b8876b/members/$ref
Content-type: application/json
{
"@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/bb165b45-151c-4cf6-9911-cd7188912848"
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 204 No Content
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für