educationUser-Ressourcentyp
Namespace: microsoft.graph
Ein Benutzer im System. Dies ist eine bildungsspezifische Variante des Benutzers mit der gleichen ID , die Microsoft Graph vom nicht bildungsspezifischen /users Endpunkt zurückgibt. Dieses Objekt stellt eine gezielte Teilmenge der Eigenschaften aus dem Kernbenutzerobjekt bereit und fügt eine Reihe von bildungsspezifischen Eigenschaften wie primaryRole-, Student- und Lehrerdaten hinzu.
Erbt von entity.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | educationUser-Sammlung | Rufen Sie eine Liste der educationUser-Objekte und deren Eigenschaften ab. |
| Create | educationUser | Erstellen Sie ein neues educationUser-Objekt . |
| Get | educationUser | Liest die Eigenschaften und Beziehungen eines educationUser-Objekts . |
| Update | educationUser | Aktualisieren sie die Eigenschaften eines educationUser-Objekts . |
| Delete | Keine | Löschen eines educationUser-Objekts. |
| Abrufen von Änderungen an Benutzern | educationUser-Sammlung | Ruft inkrementelle Änderungen an der Ressourcensammlung ab. |
| Auflisten der unterrichteten Kurse | educationClass-Sammlung | Rufen Sie die educationClass-Ressourcen aus der navigationseigenschaft taughtClasses ab. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| accountEnabled | Boolesch |
True, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird. Unterstützt $filter. |
| assignedLicenses | assignedLicense collection | Die Lizenzen, die dem Benutzer zugewiesen sind. Lässt keine NULL-Werte zu. |
| assignedPlans | assignedPlan collection | Die Pläne, die dem Benutzer zugewiesen sind. Schreibgeschützt. Lässt keine NULL-Werte zu. |
| businessPhones | String-Sammlung | Die Telefonnummern für den Benutzer. Hinweis: Obwohl dies eine String-Sammlung ist, kann nur eine Nummer für diese Eigenschaft festgelegt werden. |
| createdBy | identitySet | Die Entität, die den Benutzer erstellt hat. |
| department | Zeichenfolge | Der Name der Abteilung, in der der Benutzer arbeitet. Unterstützt $filter. |
| displayName | Zeichenfolge | Der Name des Benutzers, der im Adressbuch angezeigt wird. Dies ist normalerweise eine Kombination aus dem Vornamen, der Initiale des weiteren Vornamens und des Nachnamens. Diese Eigenschaft ist beim Erstellen eines Benutzers erforderlich und kann nicht bei Updates deaktiviert werden. Unterstützt $filter und $orderby. |
| externalSource | educationExternalSource | Quelle, aus der dieser Benutzer erstellt wurde. Mögliche Werte sind: sis und manual. |
| externalSourceDetail | Zeichenfolge | Der Name der externen Quelle, aus der diese Ressource generiert wurde. |
| givenName | Zeichenfolge | Der Vorname des Benutzers. Unterstützt $filter. |
| id | Zeichenfolge | Objektbezeichner. Geerbt von entity. |
| Zeichenfolge | SMTP-Adresse für den Benutzer, z. B. jeff@contoso.com. Schreibgeschützt. Unterstützt $filter. |
|
| mailingAddress | physicalAddress | Die E-Mail-Adresse des Benutzers. |
| mailNickname | Zeichenfolge | Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss beim Erstellen eines Benutzers angegeben werden. Unterstützt $filter. |
| middleName | String | Der zweite Name des Benutzers. |
| mobilePhone | String | Die Nummer des primären Mobiltelefons für den Benutzer. |
| officeLocation | String | Der Bürostandort für den Benutzer. |
| onPremisesInfo | educationOnPremisesInfo | Zusätzliche Informationen, die verwendet werden, um den Microsoft Entra-Benutzer seinem Active Directory-Gegenstück zuzuordnen. |
| passwordPolicies | String | Gibt die Kennwortrichtlinien für den Benutzer an. Dieser Wert ist eine Enumeration, deren einziger möglicher Wert DisableStrongPassword lautet. Damit können schwächere Kennwörter als in der Standardrichtlinie angegeben festgelegt werden. Auch DisablePasswordExpiration kann angegeben werden. Die beiden können zusammen angegeben werden; Beispiel: DisablePasswordExpiration, DisableStrongPassword. |
| passwordProfile | passwordProfile | Gibt das Kennwortprofil für den Benutzer an. Das Profil enthält das Kennwort des Benutzers. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird. Das Kennwort im Profil muss den Mindestanforderungen entsprechen, wie von der passwordPolicies-Eigenschaft angegeben. Standardmäßig ist ein sicheres Kennwort erforderlich. |
| preferredLanguage | Zeichenfolge | Die bevorzugte Sprache für den Benutzer, die dem ISO 639-1-Code folgen sollte, z. B en-US. . |
| primaryRole | educationUserRole | Standardrolle für einen Benutzer. Die Rolle des Benutzers kann in einer einzelnen Klasse unterschiedlich sein. Mögliche Werte: student, teacher, none, unknownFutureValue |
| provisionedPlans | ProvisionedPlan-Sammlung | Die Pläne, die für den Benutzer bereitgestellt wurden. Schreibgeschützt. Lässt keine NULL-Werte zu. |
| refreshTokensValidFromDateTime | DateTimeOffset | Alle vor diesem Zeitpunkt ausgegebenen Aktualisierungstoken oder Sitzungstoken (Sitzungscookies) sind ungültig, und Anwendungen erhalten einen Fehler, wenn sie ein ungültiges Aktualisierungs- oder Sitzungstoken verwenden, um ein delegiertes Zugriffstoken abzurufen (für den Zugriff auf APIs wie Microsoft Graph). In diesem Fall muss die Anwendung ein neues Aktualisierungstoken abrufen, indem sie den autorisierten Endpunkt anfordert. Wird nur auf $select zurückgegeben. Schreibgeschützt. |
| relatedContacts | relatedContact-Sammlung | Verwandte Datensätze, die dem Benutzer zugeordnet sind. Schreibgeschützt. |
| residenceAddress | physicalAddress | Die Adresse, an der sich der Benutzer befindet. |
| showInAddressList | Boolesch |
True , wenn die globale Adressliste von Outlook diesen Benutzer enthalten soll; falseandernfalls . Wenn nicht festgelegt, wird dies als true behandelt. Für Benutzer, die mit dem Einladungsmanager eingeladen wurden, wird diese Eigenschaft auf false festgelegt. |
| student | educationStudent | Ist die primäre Rolle Kursteilnehmer, enthält dieser Block spezifische Daten für Kursteilnehmer. |
| surname | Zeichenfolge | Der Nachname des Benutzers. Unterstützt $filter. |
| teacher | educationTeacher | Wenn die primäre Rolle lehrer ist, enthält dieser Block lehrerspezifische Daten. |
| usageLocation | String | Ein aus zwei Buchstaben bestehender Ländercode (ISO-Standard 3166). Erforderlich für Benutzer, denen Lizenzen zugewiesen werden, aufgrund der gesetzlichen Vorschrift, dass die Verfügbarkeit von Diensten in einzelnen Ländern oder Regionen geprüft werden muss. Beispiele sind US, JP und GB. Lässt keine NULL-Werte zu. Unterstützt $filter. |
| userPrincipalName | Zeichenfolge | Der User Principal Name (UPN) des Benutzers. Der UPN ist ein Anmeldename im Internetformat für den Benutzer, der auf dem Internetstandard RFC 822 basiert. Gemäß der Konvention sollte er dem E-Mail-Namen des Benutzers zugeordnet sein. Das allgemeine Format ist alias@domain, wobei die Domäne in der Sammlung überprüfter Domänen des Mandanten vorhanden sein muss. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird. Auf die überprüften Domänen für den Mandanten kann über die verifiedDomains-Eigenschaft der Organisation zugegriffen werden. Unterstützt $filter und $orderby. |
| userType | Zeichenfolge | Ein Zeichenfolgenwert kann zum Klassifizieren der Benutzertypen in Ihrem Verzeichnis verwendet werden, z. B. Member und Guest. Unterstützt $filter. |
Wichtig
Bei Verwendung delegierter Berechtigungsbereiche gibt Microsoft Graph nur einen begrenzten Satz von Eigenschaften zurück: id, primaryRole, accountEnabled, displayName, givenName, surname, userPrincipalName, userType, onPremisesInfo, student/externalId, teacher/externalId. Wenn Ihre Anwendung zusätzliche Eigenschaften erfordert, müssen Sie Anwendungsberechtigungsbereiche verwenden.
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| assignments | educationAssignment-Sammlung | Zuweisungen, die dem Benutzer gehören. |
| classes | educationClass-Sammlung | Klassen, zu denen der Benutzer gehört. Lässt Nullwerte zu. |
| schools | educationSchool-Sammlung | Schulen, zu denen der Benutzer gehört. Nullwerte zulassend. |
| taughtClasses | educationClass-Sammlung | Klassen, für die der Benutzer ein Lehrer ist. |
| Benutzer | user | Der Verzeichnisbenutzer, der diesem Benutzer entspricht. |
| Rubriken | educationRubric-Sammlung | Wenn diese Einstellung festgelegt ist, wird die der Aufgabe angefügte Rubrik für die Benotung verwendet. |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.educationUser",
"accountEnabled": "Boolean",
"assignedLicenses": [
{
"@odata.type": "microsoft.graph.assignedLicense"
}
],
"assignedPlans": [
{
"@odata.type": "microsoft.graph.assignedPlan"
}
],
"businessPhones": ["String"],
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"department": "String",
"displayName": "String",
"externalSource": "String",
"externalSourceDetail": "String",
"givenName": "String",
"id": "String (identifier)",
"mail": "String",
"mailingAddress": {
"@odata.type": "microsoft.graph.physicalAddress"
},
"mailNickname": "String",
"middleName": "String",
"mobilePhone": "String",
"officeLocation": "String",
"onPremisesInfo": {
"@odata.type": "microsoft.graph.educationOnPremisesInfo"
},
"passwordPolicies": "String",
"passwordProfile": {
"@odata.type": "microsoft.graph.passwordProfile"
},
"preferredLanguage": "String",
"primaryRole": "String",
"provisionedPlans": [
{
"@odata.type": "microsoft.graph.provisionedPlan"
}
],
"refreshTokensValidFromDateTime": "String (timestamp)",
"residenceAddress": {
"@odata.type": "microsoft.graph.physicalAddress"
},
"showInAddressList": "Boolean",
"student": {
"@odata.type": "microsoft.graph.educationStudent"
},
"surname": "String",
"teacher": {
"@odata.type": "microsoft.graph.educationTeacher"
},
"usageLocation": "String",
"userPrincipalName": "String",
"userType": "String"
}