appRole-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 Anwendungsrolle dar, die von einer Clientanwendung angefordert (und gewährt) werden kann, oder die zum Zuweisen einer Anwendung zu Benutzern oder Gruppen in einer angegebenen Rolle verwendet werden kann.

Aktualisieren Sie die Anwendung für die App oder den Dienst, um App-Rollen für eine Anwendung hinzuzufügen, zu aktualisieren oder zu entfernen. App-Rollen für die Anwendungsentität sind in allen Mandanten verfügbar, in denen die Anwendung verwendet wird. Um App-Rollen zu definieren, die nur in Ihrem Mandanten anwendbar sind (z. B. App-Rollen, die benutzerdefinierte Rollen in Ihrer Instanz einer mehrinstanzenfähigen Anwendung darstellen), können Sie auch den Dienstprinzipal für die App aktualisieren, um der appRoles-Sammlung App-Rollen hinzuzufügen oder zu aktualisieren.

Mit appRoleAssignments können App-Rollen Benutzern, Gruppen oder dienstprinzipalen anderen Anwendungen zugewiesen werden.

Eigenschaften

Eigenschaft	Typ	Beschreibung
allowedMemberTypes	String collection	Gibt an, ob diese App-Rolle Benutzern und Gruppen zugewiesen werden kann (durch Festlegen auf ["User"]), der einer anderen Anwendung (durch Festlegen auf ["Application"], oder beides (durch Festlegen auf ["User", "Application"]). App-Rollen, die die Zuweisung zu Dienstprinzipalen anderer Anwendungen unterstützen, werden auch als Anwendungsberechtigungen bezeichnet. Der Wert "Application" wird nur für App-Rollen unterstützt, die für Anwendungsentitäten definiert sind.
description	Zeichenfolge	Die Beschreibung für die App-Rolle. Dies wird angezeigt, wenn die App-Rolle zugewiesen wird, und, wenn die App-Rolle als Anwendungsberechtigung fungiert, während der Zustimmung.
displayName	Zeichenfolge	Anzeigename für die Berechtigung, die in den App-Rollenzuweisungs- und Zustimmungsfunktionen angezeigt wird.
id	Guid	Eindeutiger Rollenbezeichner innerhalb der appRoles-Auflistung . Sie müssen einen neuen GUID-Bezeichner angeben, wenn Sie eine neue App-Rolle erstellen.
isEnabled	Boolescher Wert	Beim Erstellen oder Aktualisieren einer App-Rolle muss dies auf true festgelegt werden (dies ist die Standardeinstellung). Um eine Rolle zu löschen, muss diese zuerst auf false festgelegt werden. An diesem Punkt kann diese Rolle in einem nachfolgenden Aufruf entfernt werden.
Ursprung	Zeichenfolge	Gibt an, ob die App-Rolle für das Anwendungsobjekt oder für die servicePrincipal-Entität definiert ist. Darf nicht in POST- oder PATCH-Anforderungen enthalten sein. Schreibgeschützt.
value	Zeichenfolge	Gibt den Wert an, der in den roles Anspruch in ID-Token und Zugriffstoken aufgenommen werden soll, die einen zugewiesenen Benutzer oder Dienstprinzipal authentifizieren. Darf 120 Zeichen nicht überschreiten. Zulässige Zeichen sind :{#$!.-,+/*)(:'&%;<@?[>]^=|~_}+`, und Zeichen in den Bereichen 0-9, A-Z und .a-z Alle anderen Zeichen, einschließlich des Leerzeichens, sind nicht zulässig. Darf nicht mit .beginnen.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "allowedMemberTypes": ["String"],
  "description": "String",
  "displayName": "String",
  "id": "Guid",
  "isEnabled": true,
  "origin": "String",
  "value": "String"
}