educationUser-Ressourcentyp

Namespace: microsoft.graph

Ein Benutzer im System. Dies ist eine bildungsspezifische Variante des Benutzers mit derselben ID, die Microsoft Graph vom nicht bildungsspezifischen /users Endpunkt zurückgibt. Dieses Objekt stellt eine gezielte Teilmenge von Eigenschaften aus dem Kernbenutzerobjekt bereit und fügt eine Reihe von bildungsspezifischen Eigenschaften wie PrimaryRole-, Schüler- und Lehrerdaten hinzu.

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
EducationUsers auflisten	educationUser-Sammlung	Dient zum Abrufen einer Liste der educationUser-Objekte und deren Eigenschaften.
EducationUser erstellen	educationUser	Erstellen sie ein neues educationUser-Objekt .
educationUser abrufen	educationUser	Lesen der Eigenschaften und Beziehungen eines educationUser-Objekts .
EducationUser aktualisieren	educationUser	Dient zum Aktualisieren der Eigenschaften eines educationUser-Objekts .
EducationUser löschen	Keine	Löschen eines educationUser-Objekts.
delta	educationUser-Sammlung	Ruft inkrementelle Änderungen an der Ressourcensammlung ab.
classes auflisten	educationClass-Sammlung	Rufen Sie die educationClass-Ressourcen aus der Navigationseigenschaft classes 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	String	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	String	Objektbezeichner. Geerbt von entity.
mail	Zeichenfolge	SMTP-Adresse für den Benutzer, z. B. jeff@contoso.onmicrosoft.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 Vorname des Benutzers.
mobilePhone	String	Die Nummer des primären Mobiltelefons für den Benutzer.
onPremisesInfo	educationOnPremisesInfo	Zusätzliche Informationen zum Zuordnen des Azure Active Directory Benutzers zu seiner Active Directory-Entsprechung.
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.
relatedContacts	[relatedContact-Auflistung]	Verknüpfte Datensätze, die dem Benutzer zugeordnet sind. Schreibgeschützt.
residenceAddress	physicalAddress	Die Adresse, in der sich der Benutzer befindet.
showInAddressList	Boolescher Wert	Truewenn die Outlook globale Adressliste 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	Zeichenfolge	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 Internetstil für den Benutzer basierend auf dem Internetstandard RFC 822. 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 der überprüften 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 Eigenschaft verifiedDomains 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	Zuordnungen, 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. Lässt Nullwerte zu.
classes	educationClass-Sammlung	Kurse, für die der Benutzer Lehrer ist.
Benutzer	user	Der Verzeichnisbenutzer, der diesem Benutzer entspricht.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.educationUser",
  "id": "String (identifier)",
  "primaryRole": "String",
  "middleName": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "residenceAddress": {
    "@odata.type": "microsoft.graph.physicalAddress"
  },
  "mailingAddress": {
    "@odata.type": "microsoft.graph.physicalAddress"
  },
  "student": {
    "@odata.type": "microsoft.graph.educationStudent"
  },
  "teacher": {
    "@odata.type": "microsoft.graph.educationTeacher"
  },
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "accountEnabled": "Boolean",
  "assignedLicenses": [
    {
      "@odata.type": "microsoft.graph.assignedLicense"
    }
  ],
  "assignedPlans": [
    {
      "@odata.type": "microsoft.graph.assignedPlan"
    }
  ],
  "businessPhones": ["String"],
  "department": "String",
  "displayName": "String",
  "givenName": "String",
  "mail": "String",
  "mailNickname": "String",
  "mobilePhone": "String",
  "passwordPolicies": "String",
  "passwordProfile": {
    "@odata.type": "microsoft.graph.passwordProfile"
  },
  "officeLocation": "String",
  "preferredLanguage": "String",
  "provisionedPlans": [
    {
      "@odata.type": "microsoft.graph.provisionedPlan"
    }
  ],
  "refreshTokensValidFromDateTime": "String (timestamp)",
  "showInAddressList": "Boolean",
  "surname": "String",
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String",
  "onPremisesInfo": {
    "@odata.type": "microsoft.graph.educationOnPremisesInfo"
  }
}