Tipo de recurso del usuario

Espacio de nombres: microsoft.graph

Representa una cuenta de usuario de Microsoft Entra. Este recurso es un tipo abierto que permite propiedades adicionales además de las documentadas aquí. Se hereda de directoryObject. Solo un subconjunto de propiedades de usuario se devuelven de forma predeterminada en v1.0. Para recuperar otras propiedades, debe especificarlas en una opción de $select consulta.

Este recurso admite:

  • que agregue sus propios datos a las propiedades personalizadas como extensiones.
  • que se suscriba a notificaciones de cambios.
  • El uso de una consulta delta para realizar un seguimiento de adiciones, eliminaciones y actualizaciones incrementales al proporcionar una función delta.

Métodos

Método Tipo de valor devuelto Descripción
List Colección user Obtiene una lista de objetos de usuario.
Crear user Crea un objeto de usuario nuevo.
Get usuario Lee las propiedades y las relaciones del objeto de usuario.
Actualizar usuario Actualiza el objeto de usuario.
Delete Ninguno Elimina el objeto de usuario.
Obtener delta Colección usario Obtener los cambios incrementales de usuarios.
Cambiar contraseña Ninguno Actualice su propia contraseña.
Reintento de aprovisionamiento del servicio Ninguno Reintente el aprovisionamiento del servicio de usuario.
Revocar sesiones de inicio de sesión Ninguno Revoca todos los tokens de actualización y de sesión del usuario emitidos a las aplicaciones al restablecer la propiedad de usuario signInSessionsValidFromDateTime a la fecha y hora actuales. Obliga al usuario a volver a iniciar sesión en esas aplicaciones.
Exportar datos personales Ninguno Envía una solicitud de operación de directiva de datos, realizada por el administrador de la empresa para exportar los datos de un usuario de la organización.
Asignaciones de roles de aplicación
Lista Colección appRoleAssignment Obtenga las aplicaciones y los roles de aplicación asignados a este usuario.
Add appRoleAssignment Asigna un rol de aplicación a este usuario.
Remove Ninguno Elimina una asignación de roles de aplicación de este usuario.
Calendario
List calendars Colección calendar Obtiene una colección de objetos de calendario.
Crear calendario Calendario Crea un nuevo calendario publicándolo en la colección de calendarios.
List calendar groups Colección calendarGroup Obtiene una colección de objetos calendarGroup.
Create calendar group CalendarGroup Crea un nuevo calendarGroup publicándolo en la colección calendarGroups.
Lista de eventos Colección event Obtiene una lista de los objetos de evento del buzón del usuario. La lista contiene patrones de serie y reuniones de instancia única.
Crear evento evento Crea un evento al publicarlo en la colección de eventos.
Buscar horas de reunión meetingTimeSuggestionsResult Encuentra horas y ubicaciones para reunirse según las restricciones de disponibilidad, ubicación u horas del asistente.
Obtener la programación de disponibilidad scheduleInformation Obtenga la información de disponibilidad de disponibilidad de una colección de usuarios, listas de distribuciones o recursos (salas o equipos) durante un período especificado.
Enumerar vista de calendario Colección event Obtiene una colección de objetos de evento.
Vista de recordatorio Colección reminder Devuelve una lista de los avisos de calendario entre las horas de inicio y finalización especificadas.
PC en la nube.
Enumerar equipos en la nube colección cloudPC Enumere los dispositivos cloudPC que se atribuyen al usuario que ha iniciado la sesión.
Seguridad y gobierno de datos
Ámbitos de protección de proceso policyUserScope collection Calcular los ámbitos de protección para el usuario que ha iniciado sesión.
Crear actividad de contenido contentActivity Cree una actividad de contenido para el usuario que ha iniciado sesión.
Contenido del proceso processContentResponse Procesar el contenido en relación con las directivas de protección de datos en el contexto del usuario que ha iniciado sesión.
Concesiones de permisos delegados
Enumerar las concesiones de permisos delegados Colección oAuth2PermissionGrant Recupere una lista de permisos delegados concedidos para permitir que una aplicación cliente acceda a una API en nombre del usuario.
Objetos de directorio
Obtener por identificadores Colección string Devuelve los objetos de directorio especificados en una lista de identificadores.
Obtener delta para el objeto de directorio Colección directoryObject Obtenga cambios incrementales para objetos de directorio, como usuarios, grupos, aplicaciones y entidades de servicio. El filtrado es necesario en el identificador del tipo derivado o en el propio tipo derivado. Para obtener más información sobre las consultas diferenciales, vea Usar la consulta delta para realizar un seguimiento de los cambios en los datos de Microsoft Graph.
Comprobar grupos de miembro Colección string Comprueba la pertenencia a una lista de grupos. La comprobación es transitiva.
Obtener grupos de miembro Colección string Devuelve todos los grupos de los que el usuario es miembro. La comprobación es transitiva.
Comprobar objetos miembro Colección de cadenas Comprobar la pertenencia en una lista de objetos de grupo, rol de directorio o unidad administrativa. La función es transitiva.
Obtener objetos de miembro Colección de cadenas Devuelve todos los grupos, unidades administrativas y roles de directorio de los que el usuario es miembro. La comprobación es transitiva.
Enumerar objetos creados Colección directoryObject Obtiene los objetos de directorio creados por el usuario desde la propiedad de navegación createdObjects.
Enumerar dispositivos en propiedad Colección directoryObject Obtenga los dispositivos que posee el usuario desde la propiedad de navegación ownedDevices.
Enumerar objetos en propiedad Colección directoryObject Obtenga los objetos de directorio propiedad del usuario de la propiedad de navegación ownedObjects.
Enumerar grupos eliminados propiedad del usuario Colección directoryObject Recupere los grupos eliminados en el inquilino en los últimos 30 días y el que es propiedad de un usuario.
Enumerar dispositivos registrados Colección directoryObject Obtiene los dispositivos registrados del usuario desde la propiedad de navegación registeredDevices.
Enumerar elementos eliminados Colección directoryObject Recupere los usuarios eliminados en el espacio empresarial en los últimos 30 días.
Obtener elemento eliminado Colección directoryObject Recuperar un usuario eliminado por identificador.
Restaurar elemento eliminado Colección directoryObject Restaurar un usuario eliminado en el espacio empresarial en los últimos 30 días.
Eliminar permanentemente Colección directoryObject Elimine del espacio empresarial a un usuario eliminado de forma permanente.
Unidad de disco
Obtener unidad drive Recupere las propiedades y relaciones de un recurso Drive.
Enumerar elementos secundarios DriveItems Devuelve una colección de objetos DriveItem en la relación de elementos secundarios de un objeto DriveItem.
Experiencia del empleado
Enumerar roles asignados engagementRole collection Obtenga una lista de todos los roles asignados a un usuario en Viva Engage.
Grupos
Enumerar equipos a los que se ha unido Colección team Obtenga el equipo de Microsoft Teams del que el usuario es miembro directo a partir de la propiedad de navegación joinedTeams.
Enumerar miembro de Colección directoryObject Obtiene los grupos, los roles de directorio y las unidades administrativas de los que el usuario es miembro directo. Esta operación no es transitiva.
Lista de miembros transitivos de Colección directoryObject Obtenga los grupos, los roles de directorio y las unidades administrativas de los que el usuario es miembro a través de la pertenencia directa o transitiva.
Información
Incluir en una lista las tendencias colección de tendencias Obtenga una lista de archivos de tendencias.
Obtener configuración de detección de contenido userSettings Obtener la configuración de detección de contenido de los usuarios.
Actualizar la configuración de detección de contenido Ninguno Actualice la configuración de detección de contenido de los usuarios.
Lista compartida (en desuso) Colección sharedInsight Obtener una lista de archivos compartidos. Esta API está en desuso y dejará de devolver datos después de noviembre de 2026.
Lista utilizada (en desuso) colección usedInsight Obtener una lista de los archivos usados. Esta API está en desuso y dejará de devolver datos después de noviembre de 2026.
Administración de licencias
Asignar licencia user Agrega o quita suscripciones del usuario. También puede habilitar y deshabilitar planes específicos asociados a una suscripción.
Enumerar detalles de licencia Colección licenseDetails Obtenga una colección de objetos licenseDetails.
Reprocesar la asignación de licencias usuario Reprocese las asignaciones de suscripción del usuario.
Correo
Enumerar carpetas de correo Colección mailFolder Obtiene la colección de carpetas de correo en la carpeta raíz del usuario que inició sesión.
Crear carpeta de correo mailFolder Crea un nuevo mailFolder publicándolo en la colección mailFolders.
Enumerar mensajes Colección message Obtiene todos los mensajes del buzón del usuario que inició sesión.
Crear mensaje message Crea un nuevo mensaje publicándolo en la colección de mensajes.
List overrides Colección inferenceClassificationOverride Obtener la Bandeja de entrada Prioritarios invalida que un usuario configuró para clasificar siempre los mensajes de determinados remitentes de maneras específicas.
Crear invalidación inferenceClassificationOverride Crear un reemplazo de Bandeja de entrada Prioritarios para un remitente identificado mediante una dirección SMTP.
Enumerar reglas Colección messageRule Obtener todos los objetos messageRule definidos para la Bandeja de entrada del usuario.
Crear regla messageRule Crear un objeto messageRule especificando un conjunto de condiciones y acciones.
Enviar correo Ninguno Envía el mensaje especificado en el cuerpo de la solicitud.
Obtener sugerencias de correo Colección mailTips Devuelve las sugerencias de correo electrónico de uno o varios destinatarios como disponible al usuario que ha iniciado sesión.
Enumerar notas Colección de notas Obtenga una lista de los objetos de nota en la carpeta Notas del usuario.
Crear nota Nota Cree una nota nueva en la carpeta Notas del usuario.
Notas
Enumerar los blocs de notas Colección notebook Recupera una lista de objetos de bloc de notas.
Crear bloc de notas Bloc de notas Crear un bloc de notas de OneNote.
Jerarquía organizativa
Asignar administrador directoryObject Asigne un usuario o un contacto organizacional como administrador de este usuario.
Obtener administrador directoryObject Obtiene el usuario o el contacto de la organización que es administrador de este usuario desde la propiedad de navegación manager.
Quitar administrador Ninguno Quitar el administrador de un usuario.
Enumerar subordinados Colección directoryObject Obtiene los usuarios y contactos que informan al usuario desde la propiedad de navegación directReports.
Configuración de Outlook
Obtener configuración del buzón del usuario mailboxSettings Obtener el mailboxSettings del usuario.
Actualizar la configuración del buzón del usuario mailboxSettings Habilite, configure o deshabilite uno o varios valores de configuración de buzón para un usuario.
Enumerar categorías de Outlook Colección outlookCategory Obtener todas las categorías definidas para el usuario.
Crear categoría de Outlook outlookCategory Crear un objeto outlookCategory en la lista principal de categorías del usuario.
Obtener idiomas admitidos Colección localeInfo Obtener una lista de idiomas y configuraciones regionales compatibles con el usuario, según la configuración del servidor de buzones del usuario.
Obtener zonas horarias compatibles Colección timeZoneInformation Obtener la lista de zonas horarias compatibles con el usuario, según la configuración del servidor de buzones del usuario.
Traducir identificadores de Exchange Colección convertIdResult Traduce entre formatos los identificadores de los recursos relacionados con Outlook.
Personas
Lista Colección person Obtenga una colección de objetos person ordenados por su relevancia para el user.
Contactos personales
Enumerar contactos Colección de contacto Obtiene una colección de contactos de la carpeta de contactos predeterminada del usuario que inició sesión.
Crear contacto contact Crea un nuevo contacto publicándolo en la colección de contactos.
Enumerar carpetas de contactos Colección contactFolder Obtiene la colección de carpetas de contactos de la carpeta de contactos predeterminada del usuario que inició sesión.
Crear carpeta de contactos contactFolder Crea un nuevo contactFolder publicándolo en la colección contactFolders.
Foto de perfil
Get profilePhoto Obtenga el objeto profilePhoto especificado o sus metadatos (propiedades profilePhoto).
Actualizar Ninguno Actualiza la foto del usuario que inició sesión o el grupo o contacto especificado.
Delete Ninguno Elimine la foto de cualquier usuario del espacio empresarial, incluido el usuario que ha iniciado sesión o el grupo especificado.
Planificador
Enumerar tareas Colección plannerTask Obtiene las plannerTasks asignadas al usuario.
Patrocinadores
Assign Ninguno Asignar un patrocinador a un usuario.
Lista Colección directoryObject Obtenga los usuarios y grupos que son patrocinadores de este usuario.
Patrocinador de la listaOf Colección directoryObject Obtenga los objetos de directorio patrocinados por este usuario.
Remove Ninguno Quitar el patrocinador de un usuario.
Teamwork
Enumerar los equipos asociados colección associatedTeamInfo Obtenga la lista de los equipos de Microsoft Teams a los que está asociado un usuario.
Lista de aplicaciones instaladas para el usuario Colección userScopeTeamsAppInstallation Enumera las aplicaciones instaladas en el ámbito personal de un usuario.
Obtiene la aplicación instalada para el usuario userScopeTeamsAppInstallation Enumera la aplicación especificada que se ha instalado en el ámbito personal de un usuario.
Agregar la aplicación para el usuario Ninguno Agrega (instala) una aplicación en el ámbito personal de un usuario.
Quitar la aplicación para el usuario Ninguno Quita (desinstala) una aplicación en el ámbito personal de un usuario.
Actualizar la aplicación instalada para el usuario Ninguno Actualiza a la versión más reciente de la aplicación instalada en el ámbito personal de un usuario.
Obtener chat entre el usuario y la aplicación Chat Enumera los chats uno a uno entre el usuario y la aplicación.
Enumerar concesiones de permisos Colección de resourceSpecificPermissionGrant Enumerar todas las concesiones de permisos específicos de recursos de un usuario.
Contratos de términos de uso
Aceptaciones de acuerdos para un usuario agreementAcceptance Recuperar los objetos agreementAcceptance de un usuario.
Tareas pendientes
Enumerar tareas Colección todoTask Obtener todos los recursos todoTask de la lista especificada.
Crear tarea todoTask Crear una todoTask en la lista de tareas específica.
Enumerar listas de tareas todoTaskList collection Obtener todas las listas de tareas del buzón del usuario.
Crear una lista de tareas todoTaskList Crear una lista de tareas de To Do en el buzón del usuario.
Configuración de usuario
Get userSettings Lea el objeto de configuración del usuario y de la organización.
Actualizar userSettings Actualizar las propiedades de la configuración del objeto.

Propiedades

Importante

El uso específico de $filter y el parámetro de consulta $search solo se admite cuando se usa el encabezado ConsistencyLevel establecido en eventual y $count. Para obtener más información, vea Funcionalidades avanzadas de consulta en objetos de directorio.

Propiedad Tipo Descripción
aboutMe String Un campo de entrada de texto de forma libre para que el usuario se describa a sí mismo. Requiere $select recuperarse.
accountEnabled Boolean true si la cuenta está habilitada; en caso contrario, false. Esta propiedad es necesaria cuando se crea un usuario.

Requiere $select recuperarse. Admite $filter (eq, ne, not y in).

Esta propiedad está sujeta a restricciones de acciones sensibles; Solo determinados roles de administrador con privilegios pueden actualizarlo.
ageGroup ageGroup Establece el grupo de edad del usuario. Valores permitidos: null, Minor, NotAdulty Adult. Para obtener más información, vea definiciones de propiedades de grupos de edad legal.

Requiere $select recuperarse. Admite $filter (eq, ne, not y in).
assignedLicenses Colección assignedLicense Las licencias que se asignan al usuario, incluidas las licencias heredadas (basadas en grupos). Esta propiedad no diferencia entre licencias asignadas directamente y licencias heredadas. Use la propiedad licenseAssignmentStates para identificar las licencias asignadas y heredadas directamente. No admite valores NULL. Requiere $select recuperarse. Admite $filter (eq, not, /$count eq 0 y /$count ne 0).
assignedPlans Colección assignedPlan Los planes asignados al usuario. Solo lectura. No admite valores NULL.

Requiere $select recuperarse. Admite $filter (eq y not).
birthday DateTimeOffset El cumpleaños del usuario. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z.

Requiere $select recuperarse.
businessPhones Colección string Números de teléfono del usuario. NOTA: Aunque es una colección de cadenas, solo se puede establecer un número para esta propiedad. Solo lectura para los usuarios sincronizados desde el directorio local.

Se devuelve de forma predeterminada. Admite $filter (eq, not, ge, le y startsWith).

Esta propiedad está sujeta a restricciones de acciones sensibles; Solo determinados roles de administrador con privilegios pueden actualizarlo.
city Cadena La ciudad donde se encuentra el usuario. La longitud máxima es de 128 caracteres.

Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
CompanyName String Nombre de la empresa a la que está asociado el usuario. Esta propiedad puede ser útil para describir la compañía de la que proviene un huésped. La longitud máxima es de 64 caracteres.

Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
consentProvidedForMinor consentProvidedForMinor Establece si se obtuvo consentimiento para menores. Valores permitidos: null, Granted, Deniedy NotRequired. Para obtener más información, vea definiciones de propiedades de grupos de edad legal.

Requiere $select recuperarse. Admite $filter (eq, ne, not y in).
country Cadena El país o región donde se encuentra el usuario; por ejemplo, US o UK. La longitud máxima es de 128 caracteres.

Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
createdDateTime DateTimeOffset La fecha y hora en que se creó el usuario, en formato ISO 8601 y UTC. El valor no se puede modificar y se rellena automáticamente cuando se crea la entidad. Admite valores NULL. Para los usuarios locales, el valor representa cuándo se crearon por primera vez en Microsoft Entra ID. La propiedad es null para algunos usuarios creados antes de junio de 2018 y usuarios locales que se sincronizaron con Microsoft Entra ID antes de junio de 2018. Solo lectura.

Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le y in).
creationType Cadena Indica si la cuenta de usuario se creó mediante alguno de los métodos siguientes:
  • Como cuenta profesional o educativa normal (null).
  • Como cuenta externa (Invitation).
  • Como cuenta local para un espacio empresarial de Azure Active Directory B2C (LocalAccount).
  • Mediante el registro de autoservicio por parte de un usuario interno mediante la comprobación de correo electrónico (EmailVerified).
  • A través del registro de autoservicio por parte de un invitado que se registra a través de un vínculo que forma parte de un flujo de usuario (SelfServiceSignUp).

Solo lectura.
Requiere $select recuperarse. Admite $filter (eq, ne, not y in).
customSecurityAttributes customSecurityAttributeValue Un tipo complejo abierto que contiene el valor de un atributo de seguridad personalizado que se asigna a un objeto de directorio. Admite un valor NULL.

Requiere $select recuperarse. Admite $filter (eq, ne, not y startsWith). El valor de filtro distingue mayúsculas de minúsculas.
  • Para leer esta propiedad, se debe asignar a la aplicación que realiza la llamada el permiso CustomSecAttributeAssignment.Read.All . Para escribir esta propiedad, se deben asignar a la aplicación que realiza la llamada los permisos CustomSecAttributeAssignment.ReadWrite.All .
  • Para leer o escribir esta propiedad en escenarios delegados, se debe asignar al administrador el rol de Administrador de asignación de atributos .
    		•
    deletedDateTime DateTimeOffset Fecha y hora en que se eliminó el usuario.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le y in).
    department Cadena Nombre del departamento en el que trabaja el usuario. La longitud máxima es de 64 caracteres.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in y eq en valores null).
    displayName Cadena Nombre del usuario que aparece en la libreta de direcciones. Este valor suele ser la combinación del nombre, la inicial del segundo nombre y el apellido del usuario. Esta propiedad es necesaria cuando se crea un usuario y no se puede borrar durante las actualizaciones. La longitud máxima es de 256 caracteres.

    Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null), $orderby y $search.
    employeeHireDate DateTimeOffset La fecha y hora en que el usuario fue contratado o comenzará a trabajar en una contratación futura.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le y in).
    employeeLeaveDateTime DateTimeOffset La fecha y hora en que el usuario abandonó o dejará la organización.
  • Para leer esta propiedad, se debe asignar a la aplicación que realiza la llamada el permiso User-LifeCycleInfo.Read.All . Para escribir esta propiedad, se deben asignar a la aplicación que realiza la llamada los permisos User.Read.All y User-LifeCycleInfo.ReadWrite.All .
  • Para leer esta propiedad en escenarios delegados, el administrador necesita al menos uno de los siguientes roles de Microsoft Entra: Administrador de flujos de trabajo del ciclo de vida (privilegios mínimos), Lector global. Para escribir esta propiedad en escenarios delegados, el administrador necesita el rol de administrador global .

    Admite $filter (eq, ne, not, ge, le y in).

    Para obtener más información, vea Configurar la propiedad employeeLeaveDateTime para un usuario.
    		•
    employeeId Cadena El identificador de empleado asignado al usuario en la organización. La longitud máxima es de 16 caracteres.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    employeeOrgData employeeOrgData Representa los datos de la organización (por ejemplo, división y costCenter) asociados a un usuario.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le y in).
    employeeType Cadena Es para capturar el tipo de trabajador de la empresa. Por ejemplo, Employee, Contractor, Consultant o Vendor. Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in y startsWith).
    externalUserState Cadena Para un invitado invitado al espacio empresarial mediante la API de invitación, esta propiedad representa el estado de invitación del usuario invitado. Para los usuarios invitados, el estado puede ser PendingAcceptance o Accepted y null para todos los demás usuarios.

    Requiere $select recuperarse. Admite $filter (eq, ne, not y in).
    externalUserStateChangeDateTime DateTimeOffset Muestra la marca de tiempo del último cambio a la propiedad externalUserState.

    Requiere $select recuperarse. Admite $filter (eq, ne, not y in).
    faxNumber Cadena El número de fax del usuario.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    givenName Cadena El nombre (nombre de pila) del usuario. La longitud máxima es de 64 caracteres.

    Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    hireDate DateTimeOffset La fecha de contratación del usuario. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z.

    Requiere $select recuperarse.
    Nota: Esta propiedad es específica de SharePoint en Microsoft 365. Se recomienda usar la propiedad nativa employeeHireDate para establecer y actualizar los valores de la fecha de contratación usando las API de Microsoft Graph.
    id String El identificador único del usuario. Se debe tratar como un identificador opaco. Heredado de directoryObject. Clave. No admite valores NULL. Solo lectura.

    Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, in).
    identidades colección objectIdentity Representa las identidades que se pueden usar para iniciar sesión en esta cuenta de usuario. Microsoft (también conocido como cuenta local), organizaciones o proveedores de identidades sociales como Facebook, Google y Microsoft pueden proporcionar la identidad y vincularla a una cuenta de usuario. Puede contener varios elementos con el mismo valor signInType .

    Requiere $select recuperarse.

    Admite $filter (eq) con limitaciones.
    imAddresses Colección string Las direcciones del protocolo de inicio de sesión (SIP) de voz sobre IP (VOIP) de mensajes instantáneos para el usuario. Solo lectura.

    Requiere $select recuperarse. Admite $filter (eq, not, ge, le y startsWith).
    interests Colección string Una lista para que el usuario describa sus intereses.

    Requiere $select recuperarse.
    isManagementRestricted Booleano true Si el usuario es miembro de una unidad administrativa de gestión restringida. Si no se establece, el valor predeterminado es null y el comportamiento predeterminado es false. Solo lectura.

    Para administrar un usuario que es miembro de una unidad administrativa de administración restringida, se debe asignar al administrador o a la aplicación que llama un rol de Microsoft Entra en el ámbito de la unidad administrativa de administración restringida.

    Requiere $select recuperarse.
    isResourceAccount Booleano No usar: reservado para uso futuro.
    jobTitle String Puesto del usuario. La longitud máxima es de 128 caracteres.

    Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    lastPasswordChangeDateTime DateTimeOffset La hora en que este usuario de Microsoft Entra cambió por última vez su contraseña o cuando se creó su contraseña, independientemente de la fecha en que se realizó la última acción. La información de fecha y hora usa el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.

    Requiere $select recuperarse.
    legalAgeGroupClassification legalAgeGroupClassification Usado por las aplicaciones empresariales para determinar el grupo de edad legal del usuario. Esta propiedad es de solo lectura y se calcula en función de las propiedades de ageGroup y consentProvidedForMinor . Valores permitidos: null, Undefined, MinorWithOutParentalConsent, MinorWithParentalConsentMinorNoParentalConsentRequired, NotAdult, y Adult. Para obtener más información, vea definiciones de propiedades de grupos de edad legal.

    Requiere $select recuperarse.
    licenseAssignmentStates Colección licenseAssignmentState Estado de asignaciones de licencia para este usuario. También indica las licencias asignadas directamente o las que el usuario heredó a través de la pertenencia a grupos. Solo lectura.

    Requiere $select recuperarse.
    mail Cadena La dirección SMTP del usuario (por ejemplo, la dirección jeff@contoso.com). Los cambios en esta propiedad actualizan la colección proxyAddresses del usuario para incluir el valor como una dirección SMTP. Esta propiedad no puede contener caracteres de acento.
    NOTA: No se recomienda actualizar esta propiedad para los perfiles de usuario de Azure AD B2C. Use la propiedad otherMails en su lugar.

    Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith, endsWith y eq en valores null).
    mailboxSettings mailboxSettings Configuración del buzón principal del usuario que inició sesión. Puede obtener o actualizar las opciones para enviar respuestas automáticas a mensajes entrantes, de configuración regional y de zona horaria.

    Requiere $select recuperarse.
    mailNickname Cadena El alias de correo del usuario. Esta propiedad debe especificarse al crear un usuario. La longitud máxima es de 64 caracteres.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    mobilePhone String El número de teléfono móvil principal del usuario. Solo lectura para los usuarios sincronizados desde el directorio local. La longitud máxima es de 64 caracteres.

    Se devuelve de forma predeterminada. Admite $filter (eq, ne, notge, le, startsWithin, , y eq en null valores) y $search.

    Esta propiedad está sujeta a restricciones de acciones sensibles; Solo determinados roles de administrador con privilegios pueden actualizarlo.
    mySite String La dirección URL del sitio del usuario.

    Requiere $select recuperarse.
    officeLocation String La ubicación de la oficina del lugar de trabajo del usuario.

    Se devuelve por defecto. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    onPremisesDistinguishedName Cadena Contiene el distinguished name o DN del Active Directory local. La propiedad solo se rellena para los clientes que sincronizan su directorio local con Microsoft Entra ID a través de Microsoft Entra Connect. Solo lectura.

    Requiere $select recuperarse.
    onPremisesDomainName Cadena Contiene el domainFQDN local, también denominado dnsDomainName, sincronizado desde el directorio local. La propiedad solo se rellena para los clientes que sincronizan su directorio local con Microsoft Entra ID a través de Microsoft Entra Connect. Solo lectura.

    Requiere $select recuperarse.
    onPremisesExtensionAttributes OnPremisesExtensionAttributes Contiene extensionAttributes1-15 para el usuario. Estos atributos de extensión se conocen también como atributos personalizados de Exchange 1-15. Cada atributo puede almacenar hasta 1024 caracteres.
  • Para un usuarioonPremisesSyncEnabled, el origen de autoridad para este conjunto de propiedades es el local y es de solo lectura.
  • Para un usuario solo en la nube (donde está onPremisesSyncEnabledfalse), estas propiedades se pueden establecer durante la creación o actualización de un objeto de usuario.
  • En el caso de un usuario basado solo en la nube previamente sincronizado desde Active Directory local, estas propiedades son de solo lectura en Microsoft Graph, pero se pueden administrar completamente a través del Centro de administración de Exchange o el módulo de Exchange Online V2 en PowerShell.

    • Requiere $select recuperarse. Admite $filter (eq, ne, not y in).
    onPremisesImmutableId Cadena Esta propiedad se usa para asociar una cuenta de usuario de Active Directory local a su objeto de usuario de Microsoft Entra. Esta propiedad debe especificarse al crear una nueva cuenta de usuario en Graph si usa un dominio federado para la propiedad userPrincipalName (UPN) del usuario. NOTA: Los $ caracteres y _ no se pueden usar al especificar esta propiedad.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le y in).

    Esta propiedad está sujeta a restricciones de acciones sensibles; Solo determinados roles de administrador con privilegios pueden actualizarlo.
    onPremisesLastSyncDateTime DateTimeOffset Indica la última vez que el objeto fue sincronizado con el directorio local; por ejemplo: 2013-02-16T03:04:54Z. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Solo lectura.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le y in).
    onPremisesProvisioningErrors Colección OnPremisesProvisioningError Errores al usar el producto de sincronización de Microsoft durante el aprovisionamiento.

    Requiere $select recuperarse. Admite $filter (eq, not, ge y le).
    onPremisesSamAccountName Cadena Contiene el samAccountName local sincronizado desde el directorio local. La propiedad solo se rellena para los clientes que sincronizan su directorio local con Microsoft Entra ID a través de Microsoft Entra Connect. Solo lectura.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in y startsWith).
    onPremisesSecurityIdentifier Cadena Contiene el identificador de seguridad local (SID) del usuario que se sincroniza desde un recurso local a la nube. Solo lectura.

    Requiere $select recuperarse. Compatibilidad $filter (eq incluidos en null valores).
    onPremisesSyncEnabled Booleano true si este objeto de usuario se está sincronizando actualmente desde un Active Directory (AD) local; de lo contrario, el usuario no se sincroniza y se puede administrar en Microsoft Entra ID. Solo lectura.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, in y eq en valores null).
    onPremisesUserPrincipalName Cadena Contiene el userPrincipalName local sincronizado desde el directorio local. La propiedad solo se rellena para los clientes que sincronizan su directorio local con Microsoft Entra ID a través de Microsoft Entra Connect. Solo lectura.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in y startsWith).
    otherMails Colección string Una lista de otras direcciones de correo electrónico para el usuario; Por ejemplo: ["bob@contoso.com", "Robert@fabrikam.com"]. Puede almacenar hasta 250 valores, cada uno con un límite de 250 caracteres.
    NOTA: Esta propiedad no puede contener caracteres de acento.

    Requiere $select recuperarse. Admite $filter (eq, not, ge, lein, startsWith, endsWith, , /$count eq 0, ). /$count ne 0

    Esta propiedad está sujeta a restricciones de acciones sensibles; Solo determinados roles de administrador con privilegios pueden actualizarlo.
    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 podrían especificarse juntos; Por ejemplo: DisablePasswordExpiration, DisableStrongPassword.

    Requiere $select recuperarse. Para obtener más información sobre las directivas de contraseñas predeterminadas, consulte Directivas de contraseñas de Microsoft Entra. Admite $filter (ne, not y eq en valores null).
    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.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, in y eq en valores null).

    Para actualizar esta propiedad:
  • User-PasswordProfile.ReadWrite.All es el permiso con privilegios mínimos para actualizar esta propiedad.
  • En escenarios delegados, el rol de administrador de usuariosde Microsoft Entra es el rol de administrador con privilegios mínimos admitido para actualizar esta propiedad para los usuarios no administradores. El Administrador de autenticación con privilegios es el rol con privilegios mínimos que se permite para actualizar esta propiedad para todos los administradores del inquilino. En general, el usuario que ha iniciado sesión debe tener un rol de administrador con privilegios superiores, como se indica en Quién puede restablecer contraseñas.
  • En escenarios de solo aplicación, se debe asignar a la aplicación que realiza la llamada un permiso compatible y , al menos, el rol de administrador de usuariosde Microsoft Entra.

    Esta propiedad también está sujeta a restricciones de acciones confidenciales.
    		•
    pastProjects Colección string Una lista para que el usuario enumere sus últimos proyectos.

    Requiere $select recuperarse.
    postalCode String El código postal de la dirección del usuario. El código postal es específico del país o región del usuario. En Estados Unidos, este atributo contiene el código postal. La longitud máxima es de 40 caracteres.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    preferredDataLocation Cadena La ubicación de datos preferida para el usuario. Para obtener más información, vea OneDrive Online Multi-Geo.
    preferredLanguage String Idioma preferido del usuario. El formato de idioma preferido se basa en RFC 4646. El nombre es una combinación de un código de referencia cultural ISO 639 de dos letras en minúsculas asociado al idioma y un código de subreferencia cultural ISO 3166 de dos letras en mayúsculas asociado al país o región. Ejemplo: "en-US" o "es-ES".

    Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null)
    preferredName String El nombre preferido del usuario. No admitido. Este atributo devuelve una cadena vacía.

    Requiere $select recuperarse.
    provisionedPlans colección provisionedPlan Planes que han sido provisionados para el usuario. Solo lectura. No admite valores NULL.

    Requiere $select recuperarse. Admite $filter (eq, not, ge y le).
    proxyAddresses Colección string Por ejemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. Cambios en la propiedad mail Actualiza esta colección para incluir el valor como una dirección SMTP. Para obtener más información, consulte propiedades mail y proxyAddresses. La dirección proxy con el prefijo SMTP (en mayúsculas) es la dirección proxy principal, mientras que esas direcciones con smtp el prefijo son las direcciones proxy secundarias. Para las cuentas de Azure AD B2C, esta propiedad tiene un límite de 10 direcciones únicas. Solo lectura en Microsoft Graph; puede actualizar esta propiedad solo a través del Centro de administración de Microsoft 365. No admite valores NULL.

    Requiere $select recuperarse. Admite $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0 y /$count ne 0).
    refreshTokensValidFromDateTime DateTimeOffset Los tokens de actualización o de sesión (cookies de sesión) emitidos antes de este momento no son válidos. Las aplicaciones obtienen un error al usar un token de actualización o sesión no válido para adquirir un token de acceso delegado (para acceder a API como Microsoft Graph). Si esto ocurre, la aplicación necesita adquirir un nuevo token de actualización solicitando el punto de conexión autorizado.

    Requiere $select recuperarse. Solo lectura.
    responsibilities Colección string Una lista para que el usuario enumere sus responsabilidades.

    Requiere $select recuperarse.
    serviceProvisioningErrors Colección serviceProvisioningError Errores publicados por un servicio federado que describen un error no transitorio específico del servicio con respecto a las propiedades o el vínculo de un objeto de usuario.

    Admite $filter (eq, not, para isResolved y serviceInstance).
    schools Colección string Una lista para que el usuario enumere las escuelas a las que asistió.

    Requiere $select recuperarse.
    securityIdentifier Cadena Identificador de seguridad (SID) del usuario, que se usa en escenarios de Windows.

    Solo lectura. Se devuelve de forma predeterminada.
    Admite $select y $filter (eq, not, ge, le, startsWith).
    showInAddressList Boolean No lo use en Microsoft Graph. En su lugar, administre esta propiedad a través del Centro de administración de Microsoft 365. Representa si el usuario debe incluirse en la lista global de direcciones de Outlook. Consulte Problema conocido.
    signInActivity signInActivity Obtenga la fecha del último inicio de sesión y solicite el id. de inicio de sesión de un usuario determinado. Solo lectura.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, gele, ), pero no con otras propiedades filtrables.

    Nota:
  • Los detalles de esta propiedad requieren una licencia de Microsoft Entra ID P1 o P2 y el permiso AuditLog.Read.All.
  • Esta propiedad no se devuelve a un usuario que nunca haya iniciado sesión o que haya iniciado sesión por última vez antes de abril de 2020.
    		•
    signInSessionsValidFromDateTime DateTimeOffset Los tokens de actualización o de sesión (cookies de sesión) emitidos antes de este momento no son válidos. Las aplicaciones obtienen un error al usar un token de actualización o sesión no válido para adquirir un token de acceso delegado (para acceder a API como Microsoft Graph). Si esto ocurre, la aplicación necesita adquirir un nuevo token de actualización solicitando el punto de conexión autorizado. Solo lectura. Use revokeSignInSessions para restablecer.

    Requiere $select recuperarse.
    skills Colección string Una lista para que el usuario enumere sus aptitudes.

    Requiere $select recuperarse.
    state Cadena El estado o la provincia de la dirección del usuario. La longitud máxima es de 128 caracteres.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    streetAddress String La dirección postal del lugar de trabajo del usuario. La longitud máxima es de 1024 caracteres.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    surname Cadena El apellido (o apellidos) del usuario. La longitud máxima es de 64 caracteres.

    Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    usageLocation String Código de país de dos letras (norma ISO 3166). Necesario para los usuarios a los que se asignan licencias debido a requisitos legales para comprobar la disponibilidad de los servicios en países o regiones. Algunos ejemplos son: USJP y GB. No admite valores NULL.

    Requiere $select recuperarse. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
    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 el estándar de Internet RFC 822. Por convención, este valor 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 verificados del inquilino desde la propiedad verifiedDomains en organización.
    NOTA: Esta propiedad no puede contener caracteres de acento. Los caracteres siguientes no están permitidos A - Z, a - z, 0 - 9, ' . - _ ! # ^ ~. Para obtener la lista completa de caracteres permitidos, vea directivas de nombre de usuario.

    Se devuelve de forma predeterminada. Admite $filter (eq, ne, not, ge, le, in, startsWith y endsWith) y $orderby.

    Esta propiedad está sujeta a restricciones de acciones sensibles; Solo determinados roles de administrador con privilegios pueden actualizarlo.
    userType Cadena Un valor de cadena que se puede usar para clasificar los tipos de usuario en el directorio. Los valores posibles son Member y .Guest

    Requiere $select recuperarse. Admite $filter (eq, ne, not, in y eq en valores null). NOTA: Para obtener más información acerca de los permisos de los miembros e invitados, consulte ¿Cuáles son los permisos de usuario predeterminados en Microsoft Entra ID?

    Sugerencia

    Las extensiones de directorio y esquema y sus datos asociados requieren $select recuperarse; Las extensiones abiertas y sus datos asociados solo se devuelven el $expand.

    propiedades mail y proxyAddresses

    mail y proxyAddresses son propiedades relacionadas con el correo electrónico. La propiedad proxyAddresses es una colección de direcciones que solo son relevantes para el servidor Microsoft Exchange. Se usa para almacenar una lista de direcciones de correo para un usuario que está vinculado a un único buzón. La propiedad mail se usa como dirección de correo electrónico del usuario para diversos fines, incluido el inicio de sesión del usuario, y define la dirección proxy principal.

    Tanto el correo como las proxyAddresses se pueden recuperar a través de la API de usuario GET . Puede actualizar el correo a través de la API de usuario de actualización , pero no puede actualizar proxyAddresses a través de Microsoft Graph. Cuando se actualiza la propiedad mail de un usuario, desencadena el recálculo de proxyAddresses y el correo recién actualizado se establece como la dirección de proxy principal, excepto en los siguientes escenarios:

    1. Si un usuario tiene una licencia que incluye Microsoft Exchange, todas sus direcciones proxy deben pertenecer a un dominio comprobado en el inquilino. Los que no pertenecen a dominios verificados, se eliminan de forma silenciosa.
    2. El correo de un usuario NO se establece en la dirección proxy principal si el usuario es un invitado y la dirección proxy principal contiene la cadena UPN del invitado con #EXT#.
    3. El correo de un usuario NO se elimina, incluso si ya no tiene direcciones proxy si el usuario es un invitado.

    Los proxyAddresses son únicos entre objetos de directorio (usuarios, grupos y contactos de la organización). Si la propiedad mail de un usuario entra en conflicto con una de las proxyAddresses de otro objeto, se produce un error al intentar actualizar el correo y la propiedad proxyAddresses tampoco se actualiza.

    En esta sección se explica cómo los administradores de Microsoft Entra y los desarrolladores de aplicaciones empresariales usan las tres propiedades de grupos de edad (legalAgeGroupClassification, ageGroup y consentProvidedForMinor) para cumplir la normativa relacionada con la edad:

    • La propiedad legalAgeGroupClassification es de sólo lectura. Lo usan los desarrolladores de aplicaciones empresariales para garantizar el control correcto de un usuario en función de su grupo de edad legal. Se calcula en función de las propiedades ageGroup y consentProvidedForMinor del usuario.
    • ageGroup y consentProvidedForMinor son propiedades opcionales utilizadas por los administradores de Microsoft Entra para ayudar a garantizar que el uso de una cuenta se controle correctamente en función de las reglas normativas relacionadas con la edad que rigen el país o la región del usuario.

    Por ejemplo: Cameron es el administrador de un directorio de una escuela primaria en Holyport (Reino Unido). Al comienzo del año escolar, utiliza el papeleo de admisión para obtener el consentimiento de los padres del menor en función de las regulaciones relacionadas con la edad del Reino Unido. El consentimiento obtenido de los padres permite que la cuenta del menor sea utilizada por Holyport School y las aplicaciones de Microsoft. Alberto crea todas las cuentas y establece ageGroup en minor y consentProvidedForMinor en granted. Las aplicaciones utilizadas por sus estudiantes pueden suprimir características que no son adecuadas para menores.

    Valores legalAgeGroupClassification

    Member Descripción
    nulo Valor predeterminado, no ageGroup está establecido para el usuario.
    Undefined No ageGroup está establecido para el usuario, pero consentProvidedForMinor es Granted, Denied, o NotRequired.
    MinorWithoutParentalConsent (Reservado para uso futuro)
    MinorWithParentalConsent El usuario se considera menor de edad en función de la normativa relacionada con la edad de su país o región y el administrador de la cuenta ha obtenido el consentimiento adecuado de un padre o tutor.
    Adulto El usuario se considera adulto en función de las normativas relacionadas con la edad de su país o región.
    NotAdult El usuario es de un país o región que tiene normativas adicionales relacionadas con la edad, como Estados Unidos, Reino Unido, la Unión Europea o Corea del Sur, y la edad del usuario está entre la edad de un menor y una edad adulta (según se estipule en el país o región). En general, esto significa que los adolescentes se consideran en notAdult países o regiones regulados.
    MinorNoParentalConsentRequired El usuario es menor de edad, pero es de un país o región que no tiene reglamentos relacionados con la edad.

    Valores de ageGroup

    Member Descripción
    nulo Valor predeterminado, no ageGroup está establecido para el usuario.
    Menor El usuario se considera un menor.
    NotAdult El usuario es de un país o región que tiene regulaciones legales, como Estados Unidos, Reino Unido, la Unión Europea o Corea del Sur, y la edad del usuario es superior al límite superior de edad infantil (según el país o región) y menor que el límite inferior de edad adulta (según se estipula según el país o región). Básicamente, los adolescentes se consideran en notAdult países / regiones regulados.
    Adulto El usuario debe ser tratado como un adulto.

    Valores de consentProvidedForMinor

    Member Descripción
    nulo Valor predeterminado, no se establece ningún consentProvidedForMinor para el usuario.
    Concedido Se obtiene el consentimiento para que el usuario tenga una cuenta.
    Denegado No se obtiene el consentimiento para que el usuario tenga una cuenta.
    NotRequired El usuario es de una ubicación que no requiere consentimiento.

    Relaciones

    Relación Tipo Descripción
    activities Colección itemActivity Las actividades de usuario en distintos dispositivos. Solo lectura. Admite valores NULL.
    adhocCalls Colección adhocCall Llamadas ad hoc asociadas con el usuario. Solo lectura. Admite valores NULL.
    agreementAcceptances Colección agreementAcceptance Los estados de aceptación de los términos de uso del usuario. Solo lectura. Admite un valor NULL.
    appRoleAssignments Colección appRoleAssignment Representa los roles de aplicación que se conceden a un usuario para una aplicación. Admite $expand.
    autenticación authentication Métodos de autenticación que se admiten para el usuario.
    calendar calendar El calendario principal del usuario. Solo lectura.
    calendarGroups Colección calendarGroup Los grupos de calendario del usuario. Solo lectura. Admite valores NULL.
    calendars Colección calendar Los calendarios del usuario. Solo lectura. Admite valores NULL.
    calendarView Colección event La vista Calendario del calendario. Solo lectura. Admite valores NULL.
    equipos en la nube colección cloudPC Los PC en la nube del usuario. Solo lectura. Admite valores NULL.
    contactFolders Colección contactFolder Las carpetas de contactos del usuario. Solo lectura. Admite valores NULL.
    contacts Colección contact Los contactos del usuario. Solo lectura. Admite valores NULL.
    createdObjects Colección directoryObject Directory objects that the user created. Solo lectura. Admite valores NULL.
    dataSecurityAndGovernance userDataSecurityAndGovernance La configuración de seguridad y gobernanza de los datos del usuario. Solo lectura. Admite valores NULL.
    directReports Colección directoryObject Los usuarios y contactos que informan al usuario (los usuarios y contactos cuya propiedad manager está establecida para este usuario). Solo lectura. Admite valores NULL. Admite $expand.
    drive drive OneDrive del usuario. Solo lectura.
    drives Colección drive Una colección de unidades disponibles para este usuario. Solo lectura.
    eventos Colección event Los eventos del usuario. La opción predeterminada muestra eventos en el calendario predeterminado. Solo lectura. Admite valores NULL.
    extensions Colección Extension La colección de extensiones abiertas definidas para el usuario. Solo lectura. Admite $expand. Admite un valor NULL.
    inferenceClassification inferenceClassification Clasificación de relevancia de los mensajes del usuario en función de designaciones explícitas que invalidan la relevancia o importancia inferida.
    insights itemInsights Representa las relaciones entre un usuario y elementos como documentos de OneDrive para el trabajo o la escuela, calculadas mediante análisis avanzados y técnicas de aprendizaje automático. Solo lectura. Admite valores NULL.
    licenseDetails Colección licenseDetails Una colección de información de la licencia de este usuario. Solo lectura.
    mailFolders Colección mailFolder Las carpetas de correo del usuario. Solo lectura. Admite valores NULL.
    manager directoryObject El usuario o contacto que es administrador de este usuario. Solo lectura. Admite $expand.
    memberOf Colección directoryObject Los grupos y los roles de directorio de los que el usuario es miembro. Solo lectura. Admite valores NULL. Es compatible con $expand.
    messages Colección message Los mensajes en un buzón o una carpeta. Solo lectura. Admite valores NULL.
    notas Colección de notas Las notas de la carpeta Notas del usuario. Solo lectura. Admite valores NULL.
    onenote onenote Solo lectura.
    onlineMeetings Colección onlineMeeting Información sobre una reunión, incluida la dirección URL usada para unirse a una reunión, la lista de asistentes y la descripción.
    outlook outlookUser Solo lectura.
    ownedDevices Colección directoryObject Dispositivos que es propiedad del usuario. Solo lectura. Admite valores NULL. Admite $expand y $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).
    ownedObjects Colección directoryObject Directory objetos de directorio de los que es propietario el usuario. Solo lectura. Admite valores NULL. Admite $expand, $select anidado en $expandy $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).
    people Colección person Usuarios que sean relevantes para el usuario. Solo lectura. Admite un valor NULL.
    permissionGrants Colección de resourceSpecificPermissionGrant Enumerar todas las concesiones de permisos específicos de recursos de un usuario.
    photo profilePhoto La foto de perfil del usuario. Solo lectura.
    photos Colección profilePhoto La colección de fotos de perfil del usuario en diferentes tamaños. Solo lectura.
    planner plannerUser Punto de entrada al recurso de Planner que puede existir para un usuario. Solo lectura.
    registeredDevices Colección directoryObject Dispositivos del usuario que están registrados. Solo lectura. Admite valores NULL. Admite $expand y devuelve hasta 100 objetos.
    Soluciones userSolutionRoot Se trata del identificador que relaciona al usuario con el horario de trabajo. Solo lectura. Admite valores NULL
    sponsorOf Colección directoryObject Objetos de directorio que este usuario patrocina, como usuarios invitados, usuarios de agente, blueprints de agente, entidades principales del blueprint de agente e identidades de agente. Si el usuario es miembro de un grupo patrocinador, los objetos patrocinados por ese grupo también se incluyen. Solo lectura. Admite valores NULL. Admite $filter, $count, $select, $expand$top, y $skip.
    patrocinadores Colección directoryObject Los usuarios y grupos responsables de los privilegios de este invitado en el inquilino y de mantener actualizada la información y el acceso del invitado. (Métodos HTTP: OBTENER, PUBLICAR, ELIMINAR). Admite $expand.
    teamwork userTeamwork Un contenedor de las características de Microsoft Teams disponibles para el usuario. Solo lectura. Admite valores NULL.
    todo todo Representa los servicios de To Do disponibles para un usuario.
    transitiveMemberOf Colección directoryObject Los grupos (incluidos los anidados) y los roles de directorio de los que el usuario es miembro. Admite valores NULL.

    Representación JSON

    La siguiente representación JSON muestra el tipo de recurso.

    {
  "aboutMe": "String",
  "accountEnabled": true,
  "ageGroup": "String",
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "birthday": "String (timestamp)",
  "businessPhones": ["String"],
  "city": "String",
  "companyName": "String",
  "consentProvidedForMinor": "String",
  "country": "String",
  "createdDateTime": "String (timestamp)",
  "creationType": "String",
  "customSecurityAttributes": {
    "@odata.type": "microsoft.graph.customSecurityAttributeValue"
  },
  "department": "String",
  "displayName": "String",
  "employeeHireDate": "2020-01-01T00:00:00Z",
  "employeeId": "String",
  "employeeOrgData": {"@odata.type": "microsoft.graph.employeeOrgData"},
  "employeeType": "String",
  "faxNumber" : "String",
  "givenName": "String",
  "hireDate": "String (timestamp)",
  "id": "String (identifier)",
  "identities": [{"@odata.type": "microsoft.graph.objectIdentity"}],
  "imAddresses": ["String"],
  "interests": ["String"],
  "isManagementRestricted": "Boolean",
  "isResourceAccount": false,
  "jobTitle": "String",
  "legalAgeGroupClassification": "String",
  "licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
  "lastPasswordChangeDateTime": "String (timestamp)",
  "mail": "String",
  "mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
  "mailNickname": "String",
  "mobilePhone": "String",
  "mySite": "String",
  "officeLocation": "String",
  "onPremisesDistinguishedName": "String",
  "onPremisesDomainName": "String",
  "onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "onPremisesImmutableId": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "onPremisesUserPrincipalName": "String",
  "otherMails": ["String"],
  "passwordPolicies": "String",
  "passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
  "pastProjects": ["String"],
  "postalCode": "String",
  "preferredDataLocation": "String",
  "preferredLanguage": "String",
  "preferredName": "String",
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "proxyAddresses": ["String"],
  "responsibilities": ["String"],
  "schools": ["String"],
  "securityIdentifier": "String",
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "showInAddressList": true,
  "signInActivity": {"@odata.type": "microsoft.graph.signInActivity"},
  "signInSessionsValidFromDateTime": "String (timestamp)",
  "skills": ["String"],
  "state": "String",
  "streetAddress": "String",
  "surname": "String",
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String",

  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarGroups": [{ "@odata.type": "microsoft.graph.calendarGroup" }],
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "calendars": [ {"@odata.type": "microsoft.graph.calendar"} ],
  "contacts": [ { "@odata.type": "microsoft.graph.contact" } ],
  "contactFolders": [ { "@odata.type": "microsoft.graph.contactFolder" } ],
  "createdObjects": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "directReports": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "drives": [ { "@odata.type": "microsoft.graph.drive" } ],
  "events": [ { "@odata.type": "microsoft.graph.event" } ],
  "inferenceClassification": { "@odata.type": "microsoft.graph.inferenceClassification" },
  "mailFolders": [ { "@odata.type": "microsoft.graph.mailFolder" } ],
  "manager": { "@odata.type": "microsoft.graph.directoryObject" },
  "memberOf": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "messages": [ { "@odata.type": "microsoft.graph.message" } ],
  "outlook": { "@odata.type": "microsoft.graph.outlookUser" },
  "ownedDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "ownedObjects": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "photos": [ { "@odata.type": "microsoft.graph.profilePhoto" } ],
  "registeredDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ]
}

    Contenido relacionado

    • Last updated on