Compartir a través de

Tabla de usuario de Azure Active Directory

  • Artículo

Nota

Azure Active Directory es ahora Microsoft Entra ID. Más información

Microsoft Dataverse incluye una tabla virtual denominada usuario de AAD (aaduser). Esta tabla virtual proporciona una conexión a Azure Active Directory (AAD) y devuelve datos sobre los usuarios dentro de su organización AAD. No se requiere configuración de la tabla virtual para usar la funcionalidad. Esta es una característica únicamente de acceso en línea.

Nota

Sus resultados con el usuario de AAD pueden diferir dependiendo de dónde se esté utilizando. El usuario de AAD en Dataverse proporcionará la lista completa de usuarios en el Azure AD de la organización. El usuario de AAD en Dataverse for Teams se limita a proporcionar todos los usuarios de AAD que también son miembros del Equipo.

El usuario de AAD no devuelve grupos ni listas de distribución.

Búsquedas usando AADUser

Puede agregar fácilmente una búsqueda a esta tabla virtual desde el portal Power Apps.

Cree una columna de búsqueda con una tabla relacionada de AADUser

Permisos

La tabla AADUser funciona con Microsoft Graph. Los usuarios de su organización deben tener asignados permisos de gráficos para poder ver y utilizar la tabla virtual AADUser.

Operaciones permitidas

Solo las operaciones de lectura y lectura múltiple son posibles a través de la tabla virtual AADUser.

Ejemplos de API web de tablas de AADUser

Esta sección contiene ejemplos de HTTP GET para acceder a datos desde la tabla AADUser.

Recuperando datos

El siguiente ejemplo ilustra cómo recuperar datos de la tabla AADUser.

Recuperar todas las filas de la tabla AADUser

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers

Recuperar los registros de AADUser con apellido 'admin'

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=surname eq 'admin'

Recuperar los registros de AADUser con apellido 'admin' o 'admin02'

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=(surname eq 'Admin02') or (surname eq 'Admin')

Recuperar registros de AADUser cuyo companyname no tenga el valor NULL

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=companyname ne null

Recuperar registros de AADUser cuyo tipo de usuario es 'Miembro'

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=usertype eq 'Member'

Recuperar registros de AADUser cuyo businessphone contiene '123-555-1212'

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=contains(businessphones, '123-555-1212')

Recuperar registros de AADUser cuyo givenname comienza con 'prueba'

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=startswith(givenname, 'test')

Recuperar registros de AADUser cuyo givenname NO comience con 'prueba'

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=not startswith(givenname, 'test')

Recuperar registros de cuenta relacionados que hagan referencia a un registro de AADUser

A continuación, new_aaduser_account es el nombre de la relación 1:N entre AADUser y la entidad Cuenta.

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers(<user ID>)?$expand=new_aaduser_account($select=accountid,name)

Hacer referencia a una fila de AADUser

El siguiente ejemplo ilustra cómo hacer referencia a una fila de la tabla AADUser.

Establecer el valor del campo de búsqueda que hace referencia a una fila de AADUser

En este ejemplo, new_testaaduserId es la propiedad de navegación de un solo valor creada con una relación 1:N personalizada entre AADUser y la entidad Cuenta. El nombre de esta propiedad de navegación se define en la propiedad OneToManyRelationshipMetadata.ReferencingEntityNavigationPropertyName de la relación. Más información: Propiedades de navegación de un solo valor.

PATCH
https://[Organization URI].crm.dynamics.com/api/data/v9.0/accounts(<account ID>)
{
  new_testaaduserId@odata.bind : "/aadusers(user ID)"
}

Consulte también

Referencia de tabla/entidad de aaduser
aaduser EntityType reference
Seguridad y datos de acceso

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).