Tipo de recurso educationUser

  • Artículo

Espacio de nombres: microsoft.graph

Usuario del sistema. Se trata de una variante específica de educación del usuario con el mismo identificador que Microsoft Graph devolverá del punto de conexión no específico /users de educación. Este objeto proporciona un subconjunto de propiedades de destino del objeto de usuario principal y agrega un conjunto de propiedades específicas de educación, como primaryRole, student y los datos del profesor .

Hereda de la entidad.

Methods

Método Tipo devuelto Descripción
Enumerar educationUsers Colección educationUser Obtenga una lista de los objetos educationUser y sus propiedades.
Crear educationUser educationUser Cree un nuevo objeto educationUser .
Obtener educationUser educationUser Lea las propiedades y relaciones de un objeto educationUser .
Actualizar educationUser educationUser Actualice las propiedades de un objeto educationUser .
Eliminar educationUser Ninguno Elimine un objeto educationUser.
delta Colección educationUser Obtenga cambios incrementales en la colección de recursos.
Enumeración de taughtClasses Colección educationClass Obtenga los recursos educationClass de la propiedad de navegación taughtClasses .

Propiedades

Propiedad Tipo Descripción
accountEnabled Boolean True si la cuenta está habilitada; en caso contrario, false. Esta propiedad es necesaria cuando se crea un usuario. Es compatible con $filter.
assignedLicenses Colección assignedLicense Las licencias asignadas al usuario. No admite valores NULL.
assignedPlans Colección assignedPlan Los planes asignados al usuario. Solo lectura. No admite valores NULL.
businessPhones Colección string Números de teléfono del usuario. Nota: Aunque se trata de una colección de cadenas, solo se puede establecer un número para esta propiedad.
createdBy identitySet Entidad que creó el usuario.
department Cadena El nombre del departamento en el que trabaja el usuario. Admite $filter.
displayName Cadena Nombre del usuario que aparece en la libreta de direcciones. Suele ser la combinación del nombre del usuario, la inicial del segundo nombre y el apellido. Esta propiedad es necesaria cuando se crea un usuario y no se puede borrar durante las actualizaciones. Admite $filter y $orderby.
externalSource educationExternalSource Indica desde dónde se ha creado este usuario. Los valores posibles son sis y manual.
externalSourceDetail Cadena Nombre del origen externo desde el que se generó este recurso.
givenName Cadena El nombre (nombre de pila) del usuario. Admite $filter.
id Cadena Identificador de objeto. Heredado de la entidad.
mail Cadena La dirección SMTP del usuario (por ejemplo, la dirección jeff@contoso.com). Solo lectura. Admite $filter.
mailingAddress physicalAddress Dirección de correo del usuario.
mailNickname Cadena El alias de correo del usuario. Esta propiedad debe especificarse al crear un usuario. Admite $filter.
middleName String El segundo nombre del usuario.
mobilePhone String El número de teléfono móvil principal del usuario.
onPremisesInfo educationOnPremisesInfo Información adicional que se usa para asociar el usuario Microsoft Entra a su homólogo de Active Directory.
passwordPolicies String Especifica las directivas de contraseña del usuario. Este valor es una enumeración con un valor posible que es DisableStrongPassword, el cual permite especificar contraseñas menos seguras que la directiva predeterminada. DisablePasswordExpiration también se puede especificar. Los dos se pueden especificar juntos; por ejemplo: DisablePasswordExpiration, DisableStrongPassword.
passwordProfile passwordProfile Especifica el perfil de contraseña del usuario. El perfil contiene la contraseña del usuario. Esta propiedad es necesaria cuando se crea un usuario. La contraseña del perfil debe cumplir los requisitos mínimos especificados por la propiedad passwordPolicies. De manera predeterminada, se requiere una contraseña segura.
preferredLanguage Cadena El idioma preferido para el usuario que debe seguir el código ISO 639-1, por ejemplo, en-US.
primaryRole educationUserRole Rol predeterminado de un usuario. Puede que el rol del usuario sea distinto en una clase individual. Los valores posibles son: student, teacher, none y unknownFutureValue.
provisionedPlans colección provisionedPlan Planes que han sido provisionados para el usuario. Solo lectura. No admite valores NULL.
relatedContacts relatedContact (colección) Registros relacionados asociados al usuario. Solo lectura.
residenceAddress physicalAddress Dirección donde reside el usuario.
showInAddressList Boolean True si la lista global de direcciones de Outlook debe contener este usuario; De lo contrario, false. Si no se establece, se tratará como true. Para los usuarios invitados a través del administrador de invitaciones, esta propiedad se establecerá en false.
student educationStudent Si el rol principal es alumno, este bloque contendrá datos específicos de alumnos.
surname Cadena El apellido (o apellidos) del usuario. Admite $filter.
teacher educationTeacher Si el rol principal es profesor, este bloque contendrá datos específicos del profesor.
usageLocation String Código de país de dos letras (norma ISO 3166). Es necesario para los usuarios a quienes se van a asignar licencias debido a un requisito legal de comprobación de disponibilidad en los países o las regiones. Algunos ejemplos son: USJP y GB. No admite valores NULL. Admite $filter.
userPrincipalName Cadena El nombre principal del usuario (UPN) del usuario. El UPN es un nombre de inicio de sesión de estilo internet para el usuario basado en la rfc 822 estándar de Internet. Por convención, se debe asignar al nombre de correo electrónico del usuario. El formato general es alias@domain, donde el dominio debe estar presente en la colección de dominios comprobados del inquilino. Esta propiedad es necesaria cuando se crea un usuario. Se puede acceder a los dominios comprobados para el inquilino desde la propiedad verifiedDomains de la organización. Admite $filter y $orderby.
userType Cadena Un valor de cadena puede utilizarse para clasificar los tipos de usuario en el directorio. Por ejemplo: Member e Guest. Admite $filter.

Importante

Al usar ámbitos de permisos delegados, Microsoft Graph solo devolverá un conjunto limitado de propiedades: id, primaryRole, accountEnabled, displayName, givenName, surname, userPrincipalName, userType, onPremisesInfo, student/externalId, teacher/externalId. Si la aplicación requiere propiedades adicionales, debe usar ámbitos de permisos de aplicación.

Relaciones

Relación Tipo Descripción
assignments colección educationAssignment Asignaciones que pertenecen al usuario.
classes Colección educationClass Clases a las que pertenece el usuario. Admite valores NULL.
schools Colección educationSchool Centros educativos a los que pertenece el usuario. Admite valores NULL.
taughtClasses Colección educationClass Clases para las que el usuario es profesor.
usuario user El usuario de directorio que corresponde a este usuario.
Rúbricas colección educationRubric Cuando se establece, la rúbrica de calificación adjunta a la asignación.

Representación JSON

La siguiente es una representación JSON del recurso

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