Type de ressource educationUser

Espace de noms: microsoft.graph

Un utilisateur dans le système. Il s’agit d’une variante spécifique à l’éducation de l’utilisateur avec le même ID que celui retourné par Microsoft Graph à partir du point de terminaison non spécifique à /users l’éducation. Cet objet fournit un sous-ensemble ciblé de propriétés de l’objet utilisateur principal et ajoute un ensemble de propriétés spécifiques à l’éducation, telles que les données primaryRole, student et teacher .

Hérite de l’entité.

Méthodes

Méthode	Type de retour	Description
Liste des objets educationUsers	Collection d’objets educationUser	Obtenez la liste des objets educationUser et de leurs propriétés.
Créer un objet educationUser	educationUser	Créez un objet educationUser .
Obtenir un objet educationUser	educationUser	Lisez les propriétés et les relations d’un objet educationUser .
Mettre à jour educationUser	educationUser	Mettez à jour les propriétés d’un objet educationUser .
Suppression d’un objet educationUser	Aucune	Supprimez un objet educationUser.
delta	Collection d’objets educationUser	Obtenez les modifications incrémentielles apportées à la collection de ressources.
Répertorier les classes enseignées	Ensemble d’objets educationClass	Obtenez les ressources educationClass à partir de la propriété de navigation taughtClasses .

Propriétés

Propriété	Type	Description
accountEnabled	Boolean	True si le compte est activé ; sinon, false. Cette propriété est requise lorsqu’un utilisateur est créé. Prend en charge $filter.
assignedLicenses	collection assignedLicense	Licences attribuées à l’utilisateur. Ne pouvant accepter la valeur null.
assignedPlans	collection assignedPlan	Plans de charge affectés à l’utilisateur. En lecture seule. Ne pouvant accepter la valeur null.
businessPhones	String collection	Numéros de téléphone de l’utilisateur. Remarque : bien qu’il s’agisse d’une collection de chaînes, seul un numéro peut être défini pour cette propriété.
createdBy	identitySet	Entité qui a créé l’utilisateur.
Service	String	Nom du service où travaille l’utilisateur. Prend en charge $filter.
displayName	String	Nom affiché dans le carnet d’adresses de l’utilisateur. Il s’agit généralement de la combinaison du prénom de l’utilisateur, de l’initiale de son deuxième prénom et de son nom. Cette propriété est requise lors de la création d’un utilisateur et ne peut pas être désactivée lors des mises à jour. Prend en charge $filter et $orderby.
externalSource	educationExternalSource	Endroit à partir duquel cet utilisateur a été créé. Les valeurs possibles sont les suivantes : sis, manual.
externalSourceDetail	Chaîne	Nom de la source externe à partir de laquelle cette ressource a été générée.
givenName	String	Prénom de l’utilisateur. Prend en charge $filter.
id	Chaîne	Identificateur d’objet. Hérité de l’entité.
messagerie	String	L’adresse SMTP de l’utilisateur, par exemple, jeff@contoso.com. En lecture seule. Prend en charge $filter.
mailingAddress	physicalAddress	Adresse de messagerie de l’utilisateur.
mailNickname	String	Alias de messagerie de l’utilisateur. Cette propriété doit être spécifiée lors de la création d’un utilisateur. Prend en charge $filter.
middleName	Chaîne	Deuxième prénom de l’utilisateur.
mobilePhone	String	Numéro de téléphone portable principal de l’utilisateur.
onPremisesInfo	educationOnPremisesInfo	Informations supplémentaires utilisées pour associer l’utilisateur Microsoft Entra à son équivalent Active Directory.
passwordPolicies	String	Spécifie les stratégies de mot de passe de l’utilisateur. Cette valeur est une énumération avec une seule valeur possible, DisableStrongPassword, qui permet de spécifier des mots de passe plus faibles que la stratégie par défaut. DisablePasswordExpiration peut également être spécifié. Les deux peuvent être spécifiés ensemble ; par exemple : DisablePasswordExpiration, DisableStrongPassword.
passwordProfile	passwordProfile	Spécifie le profil du mot de passe de l’utilisateur. Le profil contient le mot de passe de l’utilisateur. Cette propriété est requise lorsqu’un utilisateur est créé. Le mot de passe du profil doit respecter les exigences minimales spécifiées par la propriété passwordPolicies. Par défaut, un mot de passe fort est requis.
preferredLanguage	Chaîne	Langue préférée pour l’utilisateur qui doit suivre le code ISO 639-1, par exemple. en-US
primaryRole	educationUserRole	Rôle par défaut pour un utilisateur. Le rôle de l’utilisateur peut être différent dans une classe individuelle. Les valeurs possibles sont les suivantes : student, teacher, none, unknownFutureValue.
provisionedPlans	collection provisionedPlan	Plans de charge configurés pour l’utilisateur. En lecture seule. Ne pouvant accepter la valeur null.
relatedContacts	collection relatedContact	Enregistrements associés à l’utilisateur. En lecture seule.
residenceAddress	physicalAddress	Adresse où réside l’utilisateur.
showInAddressList	Valeur booléenne	True si la liste d’adresses globale Outlook doit contenir cet utilisateur ; sinon, false. Si aucune valeur n’est définie, la propriété est traitée comme true. Pour les utilisateurs invités via le gestionnaire d’invitation, cette propriété est définie sur false.
student	educationStudent	Si le rôle principal est celui d’étudiant, ce bloc contient des données spécifiques de l’étudiant.
surname	String	Nom de l’utilisateur (nom de famille). Prend en charge $filter.
teacher	educationTeacher	Si le rôle principal est enseignant, ce bloc contient des données spécifiques à l’enseignant.
usageLocation	String	Code pays à deux lettres (norme ISO 3166). Obligatoire pour les utilisateurs qui recevront des licences en raison d’une obligation légale qui exige la vérification de la disponibilité des services dans les pays ou régions. Les exemples incluent US, JP, et GB. Ne pouvant accepter la valeur null. Prend en charge $filter.
userPrincipalName	String	Nom d’utilisateur principal (UPN) de l’utilisateur. L’UPN est un nom de connexion de style Internet pour l’utilisateur basé sur la norme Internet RFC 822. Par convention, il doit être mappé sur le nom de messagerie de l’utilisateur. Le format général est alias@domain, où le domaine doit être présent dans la collection de domaines vérifiés du locataire. Cette propriété est requise lorsqu’un utilisateur est créé. Les domaines vérifiés du locataire sont accessibles à partir de la propriété verifiedDomains du organization. Prend en charge $filter et $orderby.
userType	String	Valeur de chaîne qui peut être utilisée pour classer les types d’utilisateur dans votre répertoire, tels que Member et Guest. Prend en charge $filter.

Importante

Lorsque vous utilisez des étendues d’autorisation déléguées, Microsoft Graph renvoie uniquement un ensemble limité de propriétés : id, primaryRole, accountEnabled, displayName, givenName, surname, userPrincipalName, userType, onPremisesInfo, student/externalId, teacher/externalId. Si votre application nécessite des propriétés supplémentaires, vous devez utiliser des étendues d’autorisation d’application.

Relations

Relation	Type	Description
affectations	collection educationAssignment	Affectations appartenant à l’utilisateur.
classes	Ensemble d’objets educationClass	Cours auxquels appartient l’utilisateur. Peut avoir la valeur Null.
schools	Ensemble d’objets educationSchool	Établissements scolaires auxquels appartient l’utilisateur. Pouvant accepter la valeur Null.
taughtClasses	Ensemble d’objets educationClass	Classes pour lesquelles l’utilisateur est enseignant.
utilisateur	user	Utilisateur d’annuaire qui correspond à cet utilisateur.
Rubriques	educationRubric collection	Lorsqu’elle est définie, la rubrique de notation attachée à l’affectation.

Représentation JSON

Voici une représentation JSON de la ressource.

{
  "@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"
}