Tipo de recurso del usuariouser resource type

Representa una cuenta de usuario de Azure AD. Se hereda de directoryObject.Represents an Azure AD user account. Inherits from directoryObject.

Este recurso admite:This resource supports:

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Enumerar usuariosList users Colección useruser collection Obtiene una lista de objetos de usuario.Get a list of user objects.
Crear usuarioCreate user useruser Crea un objeto de usuario nuevo.Create a new user object.
Obtener usuarioGet user usuariouser Lee las propiedades y las relaciones del objeto de usuario.Read properties and relationships of user object.
Actualizar usuarioUpdate user usuariouser Actualiza el objeto de usuario.Update user object.
Eliminar usuarioDelete user NingunoNone Elimina el objeto de usuario.Delete user object.
Enumerar mensajesList messages Colección messagemessage collection Obtiene todos los mensajes del buzón del usuario que inició sesión.Get all the messages in the signed-in user's mailbox.
Crear mensajeCreate message messagemessage Crea un nuevo mensaje publicándolo en la colección de mensajes.Create a new Message by posting to the messages collection.
Enumerar mailFoldersList mailFolders Colección mailFoldermailFolder collection Obtiene la colección de carpetas de correo en la carpeta raíz del usuario que inició sesión.Get the mail folder collection under the root folder of the signed-in user.
Crear mailFolderCreate mailFolder mailFoldermailFolder Crea un nuevo mailFolder publicándolo en la colección mailFolders.Create a new MailFolder by posting to the mailFolders collection.
sendMailsendMail NingunoNone Envía el mensaje especificado en el cuerpo de la solicitud.Send the message specified in the request body.
Enumerar eventosList events Colección eventevent collection Obtiene una lista de los objetos de evento del buzón del usuario. La lista contiene patrones de serie y reuniones de instancia única.Get a list of event objects in the user's mailbox. The list contains single instance meetings and series masters.
Crear eventoCreate event eventoevent Crea un nuevo evento publicándolo en la colección de eventos.Create a new Event by posting to the events collection.
Enumerar calendariosList calendars Colección calendarcalendar collection Obtiene una colección de objetos de calendario.Get a Calendar object collection.
Crear calendarioCreate calendar calendarcalendar Crea un nuevo calendario publicándolo en la colección de calendarios.Create a new Calendar by posting to the calendars collection.
Enumerar calendarGroupsList calendarGroups Colección calendarGroupcalendarGroup collection Obtiene una colección de objetos calendarGroup.Get a CalendarGroup object collection.
Crear calendarGroupCreate calendarGroup calendarGroupcalendarGroup Crea un nuevo calendarGroup publicándolo en la colección calendarGroups.Create a new CalendarGroup by posting to the calendarGroups collection.
Enumerar calendarViewList calendarView Colección eventevent collection Obtiene una colección de objetos de evento.Get a Event object collection.
Enumerar contactosList contacts Colección de contactocontact collection Obtiene una colección de contactos de la carpeta de contactos predeterminada del usuario que inició sesión.Get a contact collection from the default Contacts folder of the signed-in user.
Crear contactoCreate Contact contactcontact Crea un nuevo contacto publicándolo en la colección de contactos.Create a new Contact by posting to the contacts collection.
Enumerar contactFoldersList contactFolders Colección contactFoldercontactFolder collection Obtiene la colección de carpetas de contactos de la carpeta de contactos predeterminada del usuario que inició sesión.Get the contact folder collection in the default Contacts folder of the signed-in user.
Crear ContactFolderCreate ContactFolder contactFoldercontactFolder Crea un nuevo contactFolder publicándolo en la colección contactFolders.Create a new ContactFolder by posting to the contactFolders collection.
Enumerar directReportsList directReports Colección directoryObjectdirectoryObject collection Obtiene los usuarios y contactos que informan al usuario desde la propiedad de navegación directReports.Get the users and contacts that report to the user from the directReports navigation property.
Enumerar administradorList manager directoryObjectdirectoryObject Obtiene el usuario o el contacto que es administrador de este usuario desde la propiedad de navegación manager.Get the user or contact that is this user's manager from the manager navigation property.
Enumerar memberOfList memberOf Colección directoryObjectdirectoryObject collection Obtiene los grupos y los roles de directorio de los que el usuario es miembro directo desde la propiedad de navegación memberOf.Get the groups and directory roles that the user is a direct member of from the memberOf navigation property.
Enumerar memberOf transitivosList transitive memberOf Colección directoryObjectdirectoryObject collection Enumera los grupos y los roles de directorio de los que el usuario es miembro.List the groups and directory roles that the user is a member of. Esta operación es transitiva e incluye los grupos de los que este usuario es un miembro anidado.This operation is transitive and includes the groups that the user is a nested member of.
Enumerar ownedDevicesList ownedDevices Colección directoryObjectdirectoryObject collection Obtiene los dispositivos que son propiedad del usuario desde la propiedad de navegación ownedDevices.Get the devices that are owned by the user from the ownedDevices navigation property.
Enumerar ownedObjectsList ownedObjects Colección directoryObjectdirectoryObject collection Obtiene los objetos de directorio que son propiedad del usuario desde la propiedad de navegación ownedObjects.Get the directory objects that are owned by the user from the ownedObjects navigation property.
Enumerar registeredDevicesList registeredDevices Colección directoryObjectdirectoryObject collection Obtiene los dispositivos registrados del usuario desde la propiedad de navegación registeredDevices.Get the devices that are retistered for the user from the registeredDevices navigation property.
Enumerar createdObjectsList createdObjects Colección directoryObjectdirectoryObject collection Obtiene los objetos de directorio creados por el usuario desde la propiedad de navegación createdObjects.Get the directory objects created by the user from the createdObjects navigation property.
assignLicenseassignLicense useruser Agrega o quita suscripciones del usuario. También puede habilitar y deshabilitar los planes específicos asociados a una suscripción.Add or remove subscriptions for the user. You can also enable and disable specific plans associated with a subscription.
Enumerar licenseDetailsList licenseDetails Colección licenseDetailslicenseDetails collection Obtenga una colección de objetos licenseDetails.Get a licenseDetails object collection.
checkMemberGroupscheckMemberGroups Colección stringString collection Comprueba la pertenencia a una lista de grupos. La comprobación es transitiva.Check for membership in a list of groups. The check is transitive.
deltadelta Colección useruser collection Obtiene los cambios incrementales de usuarios.Get incremental changes for users.
getMemberGroupsgetMemberGroups Colección stringString collection Devuelve todos los grupos de los que el usuario es miembro. La comprobación es transitiva.Return all the groups that the user is a member of. The check is transitive.
getMemberObjectsgetMemberObjects Colección stringString collection Devuelve todos los grupos y los roles de directorio de los que el usuario es miembro. La comprobación es transitiva.Return all of the groups and directory roles that the user is a member of. The check is transitive.
reminderViewreminderView Colección reminderReminder collection Devuelve una lista de los avisos de calendario entre las horas de inicio y finalización especificadas.Return a list of calendar reminders within the start and end times specified.
revokeSignInSessionsrevokeSignInSessions NingunoNone 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.Invalidates all the user's refresh and session tokens issued to applications, by resetting the refreshTokensValidFromDateTime user property to the current date-time. Esto obligará al usuario a volver a iniciar sesión en esas aplicaciones.This forces the user to sign in to those applications again.
Extensiones abiertasOpen extensions
Crear extensión abiertaCreate open extension openTypeExtensionopenTypeExtension Crea una extensión abierta y agrega propiedades personalizadas en una instancia nueva o un recurso existente.Create an open extension and add custom properties to a new or existing resource.
Obtener extensión abiertaGet open extension Colección openTypeExtensionopenTypeExtension collection Obtiene una extensión abierta identificada por el nombre de extensión.Get an open extension identified by the extension name.
Extensiones de esquemaSchema extensions
Agregar valores de extensión de esquemaAdd schema extension values Cree una definición de extensión de esquema y, después, úsela para agregar datos escritos personalizados a un recurso.Create a schema extension definition and then use it to add custom typed data to a resource.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
aboutMeaboutMe StringString Un campo de entrada de texto de forma libre para que el usuario se describa a sí mismo.A freeform text entry field for the user to describe themselves.
accountEnabledaccountEnabled BooleanoBoolean true si la cuenta está habilitada; en caso contrario, false. Esta propiedad es necesaria cuando se crea un usuario. Es compatible con $filter.true if the account is enabled; otherwise, false. This property is required when a user is created. Supports $filter.
ageGroupageGroup CadenaString Establece el grupo de edad del usuario.Sets the age group of the user. Valores permitidos: null, minor, notAdult y adult.Allowed values: null, minor, notAdult and adult. Consulte las definiciones de propiedades del grupo de edad legal para obtener más información.Refer to the legal age group property definitions for further information.
assignedLicensesassignedLicenses Colección assignedLicenseassignedLicense collection Las licencias asignadas al usuario. No admite valores NULL.The licenses that are assigned to the user. Not nullable.
assignedPlansassignedPlans Colección assignedPlanassignedPlan collection Los planes asignados al usuario. Solo lectura. No admite valores NULL.The plans that are assigned to the user. Read-only. Not nullable.
birthdaybirthday DateTimeOffsetDateTimeOffset 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 pertenecen a la zona horaria UTC. Por ejemplo, medianoche en la zona horaria UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
businessPhonesbusinessPhones Colección stringString collection Los 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.The telephone numbers for the user. NOTE: Although this is a string collection, only one number can be set for this property.
citycity StringString La ciudad en la que se encuentra el usuario. Es compatible con $filter.The city in which the user is located. Supports $filter.
companyNamecompanyName StringString El nombre de la empresa a la que está asociado el usuario.The company name which the user is associated. Esta propiedad puede ser útil para describir la empresa de la que procede un usuario externo.This property can be useful for describing the company that an external user comes from.
consentProvidedForMinorconsentProvidedForMinor CadenaString Determina si se ha obtenido el consentimiento para menores.Sets whether consent has been obtained for minors. Valores permitidos: null, granted, denied y notRequired.Allowed values: null, granted, denied and notRequired. Consulte las definiciones de propiedades del grupo de edad legal para obtener más información.Refer to the legal age group property definitions for further information.
countrycountry StringString El país o la región en la que se encuentra el usuario. Por ejemplo: "US" o "UK". Es compatible con $filter.The country/region in which the user is located; for example, “US” or “UK”. Supports $filter.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset La fecha de creación del objeto de usuario.The created date of the user object.
departmentdepartment StringString El nombre del departamento en el que trabaja el usuario. Es compatible con $filter.The name for the department in which the user works. Supports $filter.
displayNamedisplayName StringString El 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. Es compatible con $filter y $orderby.The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial and last name. This property is required when a user is created and it cannot be cleared during updates. Supports $filter and $orderby.
employeeIdemployeeId CadenaString El identificador de empleado asignado al usuario en la organización.The employee identifier assigned to the user by the organization. Es compatible con $filter.Supports $filter.
faxNumberfaxNumber CadenaString El número de fax del usuario.The fax number of the user.
givenNamegivenName StringString El nombre (nombre de pila) del usuario. Es compatible con $filter.The given name (first name) of the user. Supports $filter.
hireDatehireDate DateTimeOffsetDateTimeOffset 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 pertenecen a la zona horaria UTC. Por ejemplo, medianoche en la zona horaria UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'The hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
idid StringString El identificador único del usuario. Heredado de directoryObject. Clave. No admite valores NULL. Solo lectura.The unique identifier for the user. Inherited from directoryObject. Key. Not nullable. Read-only.
imAddressesimAddresses Colección stringString collection Direcciones del protocolo de inicio de sesión (SIP) de voz sobre IP (VOIP) del servicio de mensajería instantánea correspondientes al usuario. Solo lectura.The instant message voice over IP (VOIP) session initiation protocol (SIP) addresses for the user. Read-only.
interestsinterests Colección stringString collection Una lista para que el usuario describa sus intereses.A list for the user to describe their interests.
isResourceAccountisResourceAccount BooleanoBoolean true si el usuario es una cuenta de recursos; en caso contrario, false.true if the user is a resource account; otherwise, false. El valor nulo se debe considerar false.Null value should be considered false.
jobTitlejobTitle StringString El puesto del usuario. Es compatible con $filter.The user’s job title. Supports $filter.
legalAgeGroupClassificationlegalAgeGroupClassification CadenaString Usado por las aplicaciones empresariales para determinar el grupo de edad legal del usuario.Used by enterprise applications to determine the legal age group of the user. Esta propiedad es de solo lectura y se calculad con las propiedades ageGroup y consentProvidedForMinor.This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. Valores permitidos: null, minorWithOutParentalConsent, minorWithParentalConsent, minorNoParentalConsentRequired, notAdult y adult.Allowed values: null, minorWithOutParentalConsent, minorWithParentalConsent, minorNoParentalConsentRequired, notAdult and adult. Consulte las definiciones de propiedades del grupo de edad legal para obtener más información.Refer to the legal age group property definitions for further information.)
licenseAssignmentStateslicenseAssignmentStates Colección licenseAssignmentStatelicenseAssignmentState collection Estado de asignaciones de licencia para este usuario.State of license assignments for this user. Solo lectura.Read-only.
mailmail StringString La dirección SMTP del usuario, por ejemplo: "jeff@contoso.onmicrosoft.com". Solo lectura. Es compatible con $filter.The SMTP address for the user, for example, "jeff@contoso.onmicrosoft.com". Read-Only. Supports $filter.
mailboxSettingsmailboxSettings mailboxSettingsmailboxSettings Configuración del buzón principal del usuario que ha iniciado sesión. Puede obtener o actualizar las opciones para enviar respuestas automáticas a mensajes entrantes, de configuración regional y de zona horaria.Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale and time zone.
mailNicknamemailNickname StringString El alias de correo del usuario. Esta propiedad debe especificarse al crear un usuario. Es compatible con $filter.The mail alias for the user. This property must be specified when a user is created. Supports $filter.
mobilePhonemobilePhone StringString El número de teléfono móvil principal del usuario.The primary cellular telephone number for the user.
mySitemySite StringString La dirección URL del sitio personal del usuario.The URL for the user's personal site.
officeLocationofficeLocation StringString La ubicación de la oficina del lugar de trabajo del usuario.The office location in the user's place of business.
onPremisesDistinguishedNameonPremisesDistinguishedName CadenaString Contiene el distinguished name o DN del Active Directory local.Contains the on-premises Active Directory distinguished name or DN. La propiedad se rellena solo para los clientes que están sincronizando su directorio local con Azure Active Directory a través de Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Solo lectura.Read-only.
onPremisesDomainNameonPremisesDomainName CadenaString Contiene el domainFQDN local, también denominado dnsDomainName, sincronizado desde el directorio local.Contains the on-premises domainFQDN, also called dnsDomainName synchronized from the on-premises directory. La propiedad se rellena solo para los clientes que están sincronizando su directorio local con Azure Active Directory a través de Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Solo lectura.Read-only.
onPremisesExtensionAttributesonPremisesExtensionAttributes OnPremisesExtensionAttributesOnPremisesExtensionAttributes Contiene los extensionAttributes 1-15 para el usuario.Contains extensionAttributes 1-15 for the user. Tenga en cuenta que los atributos de extensión individuales no se pueden seleccionar ni filtrar.Note that the individual extension attributes are neither selectable nor filterable. Para un usuario con onPremisesSyncEnabled, este conjunto de propiedades se usa como patrón localmente y es de solo lectura.For an onPremisesSyncEnabled user, this set of properties is mastered on-premises and is read-only. Para un usuario de solo nube (donde onPremisesSyncEnabled es false), estas propiedades pueden establecerse durante la creación o la actualización.For a cloud-only user (where onPremisesSyncEnabled is false), these properties may be set during creation or update.
onPremisesImmutableIdonPremisesImmutableId CadenaString Esta propiedad se utiliza para asociar una cuenta local de usuario de Active Directory a su objeto de usuario de Azure AD.This property is used to associate an on-premises Active Directory user account to their Azure AD user object. Esta propiedad debe especificarse al crear una nueva cuenta de usuario en Graph si utiliza un dominio federado para la propiedad userPrincipalName (UPN) del usuario.This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user’s userPrincipalName (UPN) property. Importante: los caracteres $ y _ no se pueden utilizar a la hora de especificar esta propiedad.Important: The $ and _ characters cannot be used when specifying this property. Es compatible con $filter.Supports $filter.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset Indica la última vez que se ha sincronizado el objeto 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 pertenecen a la zona horaria UTC. Por ejemplo, medianoche en la zona horaria UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'. Solo lectura.Indicates the last time at which the object was synced with the on-premises directory; for example: "2013-02-16T03:04:54Z". The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only.
onPremisesProvisioningErrorsonPremisesProvisioningErrors Colección OnPremisesProvisioningErroronPremisesProvisioningError collection Errores al usar el producto de sincronización de Microsoft durante el aprovisionamiento.Errors when using Microsoft synchronization product during provisioning.
onPremisesSamAccountNameonPremisesSamAccountName CadenaString Contiene el samAccountName local sincronizado desde el directorio local.Contains the on-premises samAccountName synchronized from the on-premises directory. La propiedad se rellena solo para los clientes que están sincronizando su directorio local con Azure Active Directory a través de Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Solo lectura.Read-only.
onPremisesSecurityIdentifieronPremisesSecurityIdentifier StringString Contiene el identificador de seguridad local (SID) del usuario que se sincroniza desde un recurso local a la nube. Solo lectura.Contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud. Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanoBoolean true si este objeto está sincronizado desde un directorio local; false si este objeto se ha sincronizado originalmente desde un directorio local, pero ya no está sincronizado; null si este objeto no se ha sincronizado nunca desde un directorio local (valor predeterminado). Solo lecturatrue if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). Read-only
onPremisesUserPrincipalNameonPremisesUserPrincipalName CadenaString Contiene el userPrincipalName local sincronizado desde el directorio local.Contains the on-premises userPrincipalName synchronized from the on-premises directory. La propiedad se rellena solo para los clientes que están sincronizando su directorio local con Azure Active Directory a través de Azure AD Connect.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. Solo lectura.Read-only.
otherMailsotherMails CadenaString Una lista de direcciones de correo electrónico adicionales para el usuario. Por ejemplo: ["bob@contoso.com", "Robert@fabrikam.com"].A list of additional email addresses for the user; for example: ["bob@contoso.com", "Robert@fabrikam.com"]. Es compatible con $filter.Supports $filter.
passwordPoliciespasswordPolicies StringString Especifica las directivas de contraseña del usuario. Este valor es una enumeración con un valor posible de "DisableStrongPassword" y permite especificar contraseñas menos seguras que la directiva predeterminada. También se puede especificar "DisablePasswordExpiration". Los dos se pueden especificar a la vez. Por ejemplo: "DisablePasswordExpiration, DisableStrongPassword".Specifies password policies for the user. This value is an enumeration with one possible value being “DisableStrongPassword”, which allows weaker passwords than the default policy to be specified. “DisablePasswordExpiration” can also be specified. The two may be specified together; for example: "DisablePasswordExpiration, DisableStrongPassword".
passwordProfilepasswordProfile passwordProfilePasswordProfile 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.Specifies the password profile for the user. The profile contains the user’s password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required.
pastProjectspastProjects Colección stringString collection Una lista para que el usuario enumere sus últimos proyectos.A list for the user to enumerate their past projects.
postalCodepostalCode StringString El código postal de la dirección del usuario. El código postal es específico del país o de la región del usuario. En Estados Unidos, este atributo contiene el código postal.The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code.
preferredDataLocationpreferredDataLocation CadenaString La ubicación de datos preferida para el usuario.The preferred data location for the user. Para obtener más información, vea OneDrive Online Multi-Geo.For more information, see OneDrive Online Multi-Geo.
preferredLanguagepreferredLanguage StringString El idioma preferido del usuario. Debe seguir el código ISO 639-1. Por ejemplo, "en-US".The preferred language for the user. Should follow ISO 639-1 Code; for example "en-US".
preferredNamepreferredName StringString El nombre preferido del usuario.The preferred name for the user.
provisionedPlansprovisionedPlans colección provisionedPlanProvisionedPlan collection Planes que se aprovisionan para el usuario. Solo lectura. No admite valores NULL.The plans that are provisioned for the user. Read-only. Not nullable.
proxyAddressesproxyAddresses Colección stringString collection Por ejemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] El operador any es necesario para las expresiones de filtro en las propiedades de varios valores. Solo lectura, no admite valores NULL. Es compatible con $filter.For example: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] The any operator is required for filter expressions on multi-valued properties. Read-only, Not nullable. Supports $filter.
responsibilitiesresponsibilities Colección stringString collection Una lista para que el usuario enumere sus responsabilidades.A list for the user to enumerate their responsibilities.
schoolsschools Colección stringString collection Una lista para que el usuario enumere las escuelas a las que ha ido.A list for the user to enumerate the schools they have attended.
showInAddressListshowInAddressList BooleanBoolean true si la lista global de direcciones de Outlook debe contener este usuario; de lo contrario, false.true if the Outlook global address list should contain this user, otherwise false. Si no se establece, se tratará como true.If not set, this will be treated as true. Para los usuarios invitados a través del administrador de invitaciones, esta propiedad se establecerá en false.For users invited through the invitation manager, this property will be set to false.
skillsskills Colección stringString collection Una lista para que el usuario enumere sus aptitudes.A list for the user to enumerate their skills.
signInSessionsValidFromDateTimesignInSessionsValidFromDateTime DateTimeOffsetDateTimeOffset Todos los tokens de actualización o de sesiones (cookies de la sesión) emitidos antes de esta hora no son válidos y las aplicaciones obtendrán un error al usar un token de actualización o de las sesiones no válido para obtener un token de acceso delegado (para obtener acceso a las API, como Microsoft Graph).Any refresh tokens or sessions tokens (session cookies) issued before this time are invalid, and applications will get an error when using an invalid refresh or sessions token to acquire a delegated access token (to access APIs such as Microsoft Graph). Si esto sucede, la aplicación necesitará realizar una solicitud al punto de conexión de autorización para obtener un nuevo token de actualización.If this happens, the application will need to acquire a new refresh token by making a request to the authorize endpoint. Solo lectura.Read-only. Use revokeSignInSessions para restablecer.Use revokeSignInSessions to reset.
statestate StringString El estado o la provincia de la dirección del usuario. Es compatible con $filter.The state or province in the user's address. Supports $filter.
streetAddressstreetAddress StringString La dirección postal del lugar de trabajo del usuario.The street address of the user's place of business.
surnamesurname StringString El apellido (o apellidos) del usuario. Es compatible con $filter.The user's surname (family name or last name). Supports $filter.
usageLocationusageLocation StringString Un código de país de dos letras (norma ISO 3166). Es necesario para los usuarios a los que se asignarán licencias debido a un requisito legal para comprobar la disponibilidad de los servicios en los países. Algunos ejemplos son: "US", "JP" y "GB". No admite valores NULL. Es compatible con $filter.A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries. Examples include: "US", "JP", and "GB". Not nullable. Supports $filter.
userPrincipalNameuserPrincipalName StringString El nombre principal del usuario (UPN) del usuario. El UPN es un nombre de inicio de sesión de Internet del usuario basado en la norma RFC 822. Por convención, se debe asignar al nombre de correo electrónico del usuario. El formato general es alias@dominio, donde el dominio debe estar presente en la colección de dominios verificados 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. Es compatible con $filter y $orderby.The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant’s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization. Supports $filter and $orderby.
userTypeuserType StringString Un valor de cadena que puede utilizarse para clasificar los tipos de usuario en el directorio. Por ejemplo: "Miembro" e "Invitado". Es compatible con $filter.A string value that can be used to classify user types in your directory, such as “Member” and “Guest”. Supports $filter.

Esta sección explica cómo los administradores de Azure AD y desarrolladores de aplicaciones empresariales usan las tres propiedades del grupo de edad (legalAgeGroupClassification, ageGroup y consentProvidedForMinor) para cumplir las normativas relacionados con la edad.This section explains how the three age group properties (legalAgeGroupClassification, ageGroup and consentProvidedForMinor) are used by Azure AD administrators and enterprise application developers to meet age-related regulations.

Por ejemplo: Alberto es administrador de un directorio para una escuela primaria en Holyport en el Reino Unido.For example: Cameron is administrator of a directory for an elementary school in Holyport in the United Kingdom. Al principio del año escolar usa los documentos de admisión para obtener consentimiento de los padres de los menores basándose en los reglamentos relacionados con la edad del Reino Unido.At the beginning of the school year he uses the admissions paperwork to obtain consent from the minor's parents based on the age-related regulations of the United Kingdom. El consentimiento obtenido por los padres permite que la escuela de Holyport y las aplicaciones de Microsoft puedan usar la cuenta del menor.The consent obtained from the parent allows the minor's account to be used by Holyport school and Microsoft apps. Alberto crea todas las cuentas y establece ageGroup como "menores" y consentProvidedForMinor como "concedido".Cameron then creates all the accounts and sets ageGroup to "minor" and consentProvidedForMinor to "granted". Las aplicaciones que utilizan sus estudiantes ahora pueden suprimir las características que no son adecuadas para menores.Applications used by his students are then able to suppress features that are not suitable for minors.

Los desarrolladores de aplicaciones empresariales usan esta propiedad de solo lectura para asegurar el tratamiento correcto de un usuario en función de su grupo de edad legal.This read-only property is used by enterprise application developers to ensure the correct handling of a user based on their legal age group. Se calcula según las propiedades ageGroup y consentProvidedForMinor del usuario.It is calculated based on the user's ageGroup and consentProvidedForMinor properties.

ValorValue # DescripciónDescription
nulonull 00% Valor predeterminado, no se ha establecido ageGroup para el usuario.Default value, no ageGroup has been set for the user.
minorWithoutParentalConsentminorWithoutParentalConsent 11 (Reservado para uso futuro)(Reserved for future use)
minorWithParentalConsentminorWithParentalConsent 22 El usuario se considera un menor según las normas relacionados con la edad de su país o región y el administrador de la cuenta ha obtenido consentimiento de sus padres o tutores.The user is considered a minor based on the age-related regulations of their country or region and the administrator of the account has obtained appropriate consent from a parent or guardian.
adultadult 33 El usuario se considera un adulto según las normas relacionados con la edad de su país o región.The user considered an adult based on the age-related regulations of their country or region.
notAdultnotAdult 44 El usuario se encuentra en un país o región con normas adicionales relacionados con la edad (como Estados Unidos, Reino Unido, Unión Europea o Corea del sur) y la edad del usuario está entre la minoría de edad y una edad adulta (según estipula su país o región).The user is from a country or region that has additional age-related regulations (such as the United States, United Kingdom, European Union or South Korea), and the user's age is between a minor and an adult age (as stipulated based on country or region). Por lo general, esto significa que los adolescentes se consideran notAdult en países regulados.Generally, this means that teenagers are considered as notAdult in regulated countries.
minorNoParentalConsentRequiredminorNoParentalConsentRequired 55 El usuario es menor de edad, pero es de un país o región que no tiene reglamentos relacionados con la edad.The user is a minor but is from a country or region that has no age-related regulations.

Las propiedades del grupo de edad y el consentimiento de menores son propiedades opcionales utilizadas por los administradores de Azure AD para asegurar que el uso de una cuenta se realiza correctamente según las normas de regulación relacionadas con la edad en el país o región del usuario.The age group and minor consent properties are optional properties used by Azure AD administrators to help ensure the use of an account is handled correctly based on the age-related regulatory rules governing the user's country or region.

propiedad ageGroupageGroup property

ValorValue # DescripciónDescription
nulonull 00% Valor predeterminado, no se ha establecido ageGroup para el usuario.Default value, no ageGroup has been set for the user.
minorminor 11 El usuario se considera un menor.The user is consider a minor.
notAdultnotAdult 22 El usuario se encuentra en un país que tiene normas legales (Estados Unidos, Reino Unido, Unión Europea o Corea del sur) y la edad del usuario es mayor que el límite de edad de niños (según el país) e inferior al límite mínimo de edad adulta (según estipula su país o región).The user is from a country that has statutory regulations United States, United Kingdom, European Union or South Korea) and user’s age is more than the upper limit of kid age (as per country) and less than lower limit of adult age (as stipulated based on country or region). Así que, básicamente, los adolescentes se consideran notAdult en países regulados.So basically, teenagers are considered as notAdult in regulated countries.
adultadult 33 El usuario debe ser tratado como un adulto.The user should be a treated as an adult.

propiedad consentProvidedForMinorconsentProvidedForMinor property

ValorValue # DescripciónDescription
nulonull 00% Valor predeterminado, no se ha establecido consentProvidedForMinor para el usuario.Default value, no consentProvidedForMinor has been set for the user.
grantedgranted 11 Se ha obtenido el consentimiento para que el usuario tenga una cuenta.Consent has been obtained for the user to have an account.
denieddenied 22 No se ha obtenido el consentimiento para que el usuario tenga una cuenta.Consent has not been obtained for the user to have an account.
notRequirednotRequired 33 El usuario se encuentra en una ubicación que no requiere consentimiento.The user is from a location that does not require consent.

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
activitiesactivities Colección itemActivityuserActivity collection Las actividades de usuario en distintos dispositivos.The user's activities across devices. Solo lectura.Read-only. Admite valores NULL.Nullable.
calendarcalendar calendarcalendar El calendario principal del usuario. Solo lectura.The user's primary calendar. Read-only.
calendarGroupscalendarGroups Colección calendarGroupcalendarGroup collection Los grupos de calendario del usuario. Solo lectura. Admite valores NULL.The user's calendar groups. Read-only. Nullable.
calendarViewcalendarView Colección eventevent collection La vista Calendario del calendario. Solo lectura. Admite valores NULL.The calendar view for the calendar. Read-only. Nullable.
calendarscalendars Colección calendarcalendar collection Los calendarios del usuario. Solo lectura. Admite valores NULL.The user's calendars. Read-only. Nullable.
contactFolderscontactFolders Colección contactFoldercontactFolder collection Las carpetas de contactos del usuario. Solo lectura. Admite valores NULL.The user's contacts folders. Read-only. Nullable.
contactscontacts Colección contactcontact collection Los contactos del usuario. Solo lectura. Admite valores NULL.The user's contacts. Read-only. Nullable.
createdObjectscreatedObjects Colección directoryObjectdirectoryObject collection Objetos de directorio creados por el usuario. Solo lectura. Admite valores NULL.Directory objects that were created by the user. Read-only. Nullable.
directReportsdirectReports Colección directoryObjectdirectoryObject collection 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.The users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable.
drivedrive drivedrive OneDrive del usuario. Solo lectura.The user's OneDrive. Read-only.
drivesdrives Colección drivedrive collection Una colección de unidades disponibles para este usuario. Solo lectura.A collection of drives available for this user. Read-only.
eventosevents Colección eventevent collection Los eventos del usuario. La opción predeterminada muestra eventos en el calendario predeterminado. Solo lectura. Admite valores NULL.The user's events. Default is to show Events under the Default Calendar. Read-only. Nullable.
extensionsextensions Colección Extensionextension collection La colección de extensiones abiertas definidas para el usuario. Solo lectura. Admite valores NULL.The collection of open extensions defined for the user. Read-only. Nullable.
inferenceClassificationinferenceClassification inferenceClassificationinferenceClassification Clasificación de relevancia de los mensajes del usuario según las designaciones explícitas que invalidan una relevancia o importancia inferida.Relevance classification of the user's messages based on explicit designations which override inferred relevance or importance.
licenseDetailslicenseDetails Colección licenseDetailslicenseDetails collection Una colección de información de la licencia de este usuario.A collection of this user's license details. Solo lectura.Read-only.
mailFoldersmailFolders Colección mailFoldermailFolder collection Las carpetas de correo del usuario. Solo lectura. Admite valores NULL.The user's mail folders. Read-only. Nullable.
managermanager directoryObjectdirectoryObject El usuario o el contacto que es administrador de este usuario. Solo lectura. (métodos HTTP: GET, PUT y DELETE).The user or contact that is this user’s manager. Read-only. (HTTP Methods: GET, PUT, DELETE.)
memberOfmemberOf Colección directoryObjectdirectoryObject collection Los grupos y los roles de directorio de los que el usuario es miembro. Solo lectura. Admite valores NULL.The groups and directory roles that the user is a member of. Read-only. Nullable.
messagesmessages Colección messagemessage collection Los mensajes en un buzón o una carpeta. Solo lectura. Admite valores NULL.The messages in a mailbox or folder. Read-only. Nullable.
onenoteonenote onenoteonenote Solo lectura.Read-only.
outlookoutlook outlookUseroutlookUser Solo lectura.Read-only.
ownedDevicesownedDevices Colección directoryObjectdirectoryObject collection Dispositivos que son propiedad del usuario. Solo lectura. Admite valores NULL.Devices that are owned by the user. Read-only. Nullable.
ownedObjectsownedObjects Colección directoryObjectdirectoryObject collection Objetos de directorio que son propiedad del usuario. Solo lectura. Admite valores NULL.Directory objects that are owned by the user. Read-only. Nullable.
peoplepeople Colección personperson collection Usuarios que sean relevantes para el usuario.People that are relevant to the user. Solo lectura.Read-only. Admite valores NULL.Nullable.
photophoto profilePhotoprofilePhoto La foto de perfil del usuario. Solo lectura.The user's profile photo. Read-only.
plannerplanner plannerUserplannerUser Punto de entrada al recurso de Planner que puede existir para un usuario.Entry-point to the Planner resource that might exist for a user. Solo lectura.Read-only.
registeredDevicesregisteredDevices Colección directoryObjectdirectoryObject collection Dispositivos del usuario que están registrados. Solo lectura. Admite valores NULL.Devices that are registered for the user. Read-only. Nullable.

Representación JSONJSON representation

Aquí tiene una representación JSON del recursoHere is a JSON representation of the resource

{
  "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",
  "department": "string",
  "displayName": "string",
  "employeeId": "string",
  "faxNumber" : "string",
  "givenName": "string",
  "hireDate": "String (timestamp)",
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "interests": ["string"],
  "isResourceAccount": false,
  "jobTitle": "string",
  "legalAgeGroupClassification": "string",
  "licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
  "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"],
  "showInAddressList": true,
  "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" },
  "registeredDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ]
}

Recursos adicionalesSee also