Partager via


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
List Collection d’objets educationUser Obtenez la liste des objets educationUser et de leurs propriétés.
Create educationUser Créez un objet educationUser .
Obtenir educationUser Lisez les propriétés et les relations d’un objet educationUser .
Mettre à jour educationUser Mettez à jour les propriétés d’un objet educationUser .
Supprimer Aucun Supprimez un objet educationUser.
Obtenir les modifications apportées aux utilisateurs Collection d’objets educationUser Obtenez les modifications incrémentielles apportées à la collection de ressources.
Lister 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.
officeLocation Chaîne Emplacement du bureau 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.
refreshTokensValidFromDateTime DateTimeOffset Tous les jetons d’actualisation ou de session (cookies de session) émis avant cette heure ne sont pas valides, et les applications reçoivent une erreur lors de l’utilisation d’un jeton d’actualisation ou de session non valide pour acquérir un jeton d’accès délégué (pour accéder aux API telles que Microsoft Graph). Si cela se produit, l’application doit acquérir un nouveau jeton d’actualisation en demandant le point de terminaison autorisé.

Renvoyé uniquement sur $select. En lecture seule.
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 de l’organisation. 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 utilisateur 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

La représentation JSON suivante montre le type de 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"
}