educationUser-RessourcentypeducationUser resource type

Ein Benutzer im System.A user in the system. Dies ist eine bildungsspezifische Variante des Benutzers mit derselben id, den Microsoft Graph vom nicht bildungsspezifischen /users-Endpunkt zurückgibt.This is an education-specific variant of the user with the same id that Microsoft Graph will return from the non-education-specific /users endpoint. Dieses Objekt enthält eine gezielte Teilmenge von Eigenschaften des user-Kernobjekts, erweitert um eine Reihe bildungsspezifischer Eigenschaften wie primaryRole, Kursteilnehmer- und Lehrerdaten.This object provides a targeted subset of properties from the core user object and adds a set of education-specific properties such as primaryRole, student, and teacher data.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
educationUser abrufenGet educationUser educationUsereducationUser Lesen von Eigenschaften und Beziehungen eines educationUser-Objekts.Read properties and relationships of an educationUser object.
Klassen auflistenList classes educationClass-SammlungeducationClass collection Abrufen der educationClass-Objektsammlung, in der der Benutzer Mitglied ist.Get the educationClass object collection for which the user is member.
Schulen auflistenList schools educationSchool-SammlungeducationSchool collection Abrufen der educationSchool-Objektsammlung, in der der Benutzer Mitglied ist.Get the educationSchool object collection for which the user is a member.
Benutzer abrufenGet user useruser Abrufen des einfachen Verzeichnis-Benutzers, der diesem educationUser entspricht.Get the simple directory user that corresponds to this educationUser.
AktualisierenUpdate educationUsereducationUser Aktualisieren eines educationUser-Objekts.Update an educationUser object.
LöschenDelete KeineNone Löschen eines educationUser-Objekts.Delete an educationUser object.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
accountEnabledaccountEnabled BooleanBoolean True, wenn das Konto aktiviert ist; andernfalls false.True if the account is enabled; otherwise, false. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird.This property is required when a user is created. Unterstützt $filter.Supports $filter.
assignedLicensesassignedLicenses assignedLicense collectionassignedLicense collection Die Lizenzen, die dem Benutzer zugewiesen sind. Lässt keine NULL-Werte zu.The licenses that are assigned to the user. Not nullable.
assignedPlansassignedPlans assignedPlan-SammlungassignedPlan collection Die Pläne, die dem Benutzer zugewiesen sind. Schreibgeschützt. Lässt keine NULL-Werte zu.The plans that are assigned to the user. Read-only. Not nullable.
businessPhonesbusinessPhones String-SammlungString collection Die Telefonnummern für den Benutzer.The telephone numbers for the user. Hinweis: Obwohl dies eine String-Sammlung ist, kann nur eine Nummer für diese Eigenschaft festgelegt werden.Note: Although this is a string collection, only one number can be set for this property.
createdBycreatedBy identitySetidentitySet Entität, die den Benutzer erstellt hat.Entity who created the user.
departmentdepartment ZeichenfolgeString Der Name der Abteilung, in der der Benutzer arbeitet. Unterstützt $filter.The name for the department in which the user works. Supports $filter.
displayNamedisplayName ZeichenfolgeString Der Name des Benutzers, der im Adressbuch angezeigt wird.The name displayed in the address book for the user. Dies ist normalerweise eine Kombination aus dem Vornamen, der Initiale des weiteren Vornamens und des Nachnamens.This is usually the combination of the user's first name, middle initial, and last name. Diese Eigenschaft ist beim Erstellen eines Benutzers erforderlich und kann nicht bei Updates deaktiviert werden.This property is required when a user is created and it cannot be cleared during updates. Unterstützt $filter und $orderby.Supports $filter and $orderby.
externalSourceexternalSource educationExternalSource Quelle, aus der dieser Benutzer erstellt wurde.Where this user was created from. Die möglichen Werte sind: sis, manual, unkownFutureValue.The possible values are: sis, manual, unkownFutureValue.
givenNamegivenName ZeichenfolgeString Der Vorname des Benutzers. Unterstützt $filter.The given name (first name) of the user. Supports $filter.
idid StringString Der eindeutige Bezeichner des Benutzers. Geerbt von directoryObject. Key. Lässt keine Nullwerte zu. Schreibgeschützt.The unique identifier for the user. Inherited from directoryObject. Key. Not nullable. Read-only.
mailmail StringString Die SMTP-Adresse des Benutzers, z. B. „jeff@contoso.onmicrosoft.com“.The SMTP address for the user; for example, "jeff@contoso.onmicrosoft.com". Schreibgeschützt.Read-Only. Unterstützt $filter.Supports $filter.
mailingAddressmailingAddress physicalAddressphysicalAddress E-Mail-Adresse des BenutzersMail address of user.
mailNicknamemailNickname ZeichenfolgeString Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss beim Erstellen eines Benutzers angegeben werden. Unterstützt $filter.The mail alias for the user. This property must be specified when a user is created. Supports $filter.
middleNamemiddleName StringString Der zweite Vorname des BenutzersThe middle name of user.
mobilePhonemobilePhone ZeichenfolgeString Die Nummer des primären Mobiltelefons für den Benutzer.The primary cellular telephone number for the user.
passwordPoliciespasswordPolicies ZeichenfolgeString Gibt die Kennwortrichtlinien für den Benutzer an.Specifies password policies for the user. 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.This value is an enumeration with one possible value being “DisableStrongPassword”, which allows weaker passwords than the default policy to be specified. Auch „DisablePasswordExpiration“ kann angegeben werden.“DisablePasswordExpiration” can also be specified. Die beiden können zusammen angegeben werden. Beispiel: "DisablePasswordExpiration, DisableStrongPassword".The two can be specified together; for example: "DisablePasswordExpiration, DisableStrongPassword".
passwordProfilepasswordProfile PasswordProfilePasswordProfile 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.Specifies the password profile for the user. The profile contains the user’s password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required.
preferredLanguagepreferredLanguage ZeichenfolgeString Die bevorzugte Sprache für den Benutzer.The preferred language for the user. Muss im ISO 639-1-Code angegeben werden. Beispiel: „en-US“.Should follow ISO 639-1 Code; for example, "en-US".
primaryRoleprimaryRole educationUserRoleeducationUserRole Standardrolle für einen Benutzer.Default role for a user. Die Rolle des Benutzers kann in einer einzelnen Klasse unterschiedlich sein.The user's role might be different in an individual class. Die möglichen Werte sind: student, teacher, unknownFutureValue.The possible values are: student, teacher, unknownFutureValue. Unterstützt $filter.Supports $filter.
provisionedPlansprovisionedPlans ProvisionedPlan collectionProvisionedPlan collection Die Pläne, die für den Benutzer bereitgestellt wurden. Schreibgeschützt. Lässt keine NULL-Werte zu.The plans that are provisioned for the user. Read-only. Not nullable.
residenceAddressresidenceAddress physicalAddressphysicalAddress Die Wohnadresse des BenutzersAddress where user lives.
studentstudent educationStudenteducationStudent Ist die primäre Rolle Kursteilnehmer, enthält dieser Block spezifische Daten für Kursteilnehmer.If the primary role is student, this block will contain student specific data.
surnamesurname ZeichenfolgeString Der Nachname des Benutzers. Unterstützt $filter.The user's surname (family name or last name). Supports $filter.
teacherteacher educationTeachereducationTeacher Ist die primäre Rolle Lehrer, enthält dieser Block lehrerspezifische Daten.If the primary role is teacher, this block will conatin teacher specific data.
usageLocationusageLocation StringString Ein aus zwei Buchstaben bestehender Ländercode (ISO-Standard 3166).A two-letter country code (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.Required for users who will be assigned licenses due to a legal requirement to check for availability of services in countries or regions. Beispiele: "DE", "GB" und "US".Examples include: "US", "JP", and "GB". Lässt keine Nullwerte zu.Not nullable. Unterstützt $filter.Supports $filter.
userPrincipalNameuserPrincipalName StringString Der User Principal Name (UPN) des Benutzers. Der UPN ist ein Anmeldename des Benutzers im Internetformat, der auf dem Internetstandard RFC 822 basiert. Gemäß der Konvention sollte er dem E-Mail-Namen des Benutzers zugeordnet sein. Das allgemeine Format lautet „alias@domäne“, wobei „domäne“ in der Sammlung der verifizierten Domänen des Mandanten vorhanden sein muss. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird. Auf die verifizierten Domänen für den Mandanten kann über die verifiedDomains -Eigenschaft von organization zugegriffen werden. Unterstützt $Filter und $orderby.The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant’s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization. Supports $filter and $orderby.
userTypeuserType ZeichenfolgeString Ein Zeichenfolgenwert kann zum Klassifizieren der Benutzertypen in Ihrem Verzeichnis verwendet werden, z. B. „Member“ und „Guest“. Unterstützt $filter.A string value that can be used to classify user types in your directory, such as “Member” and “Guest”. Supports $filter.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
classesclasses educationClass-SammlungeducationClass collection Klassen, zu denen der Benutzer gehört.Classes to which the user belongs. Lässt Nullwerte zu.Nullable.
schoolsschools educationSchool-SammlungeducationSchool collection Schulen, zu denen der Benutzer gehört.Schools to which the user belongs. Lässt Nullwerte zu.Nullable.
assignmentsassignments educationAssignmenteducationAssignment Liste der Zuordnungen für den Benutzer.List of assignments for the user. Lässt Nullwerte zu.Nullable.
useruser Benutzeruser Der Directory-Benutzer, die diesen Benutzer entspricht.The directory user corresponding to this user.

Hinweis: Bei der educationassignment-Ressource handelt es sich um eine /beta-Version.Note: The educationassignment resource is a /beta version resource. Wenn Sie diese Ressource verwenden, überprüfen Sie unbedingt in regelmäßigen Abständen das Änderungsprotokoll.If using this resource, be sure to review the change log periodically. Wenn Microsoft Graph-API-Ressourcen im /v1.0-Endpunkt veröffentlicht werden, wird die Version im Änderungsprotokoll aufgeführt.When Microsoft Graph API resources are released to the /v1.0 endpoint, the release is noted in the change log. Wenn Ihre App die educationassignment-Ressource nutzt, müssen Sie die Basisanforderungs-URLs wie im folgenden Codeblock deklarieren:If your app consumes the educationassignment resource, you will need to declare base request URLs as shown in the following code block:

var v1BaseUrl = “https://graph.microsoft.com/v1.0/education”;
var betaBaseUrl = “https://graph.microsoft.com/beta/education”;  // for administrativeUnit and educationOrganization

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.

{
  "id": "string",
  "accountEnabled": true,
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "businessPhones": ["555-555-6568"],
  "department": "string",
  "displayName": "string",
  "givenName": "string",
  "middleName": "string",
  "surname": "string",
  "mail": "string",
  "mailNickname": "string",
  "mobilePhone": "string",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "externalSource": "string",
  "mailingAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "passwordPolicies": "string",
  "passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
  "preferredLanguage": "string",
  "primaryRole": "string",
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "residenceAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "student": {"@odata.type": "microsoft.graph.educationStudent"},
  "teacher": {"@odata.type": "microsoft.graph.educationTeacher"},
  "usageLocation": "string",
  "userPrincipalName": "string",
  "userType": "string"
}