Grupos y usuarios de MS Graph
El conector grupos y usuarios de MS Graph ayuda a recuperar grupos, miembros (usuarios) y detalles de licencia de Microsoft Entra ID
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Jay Jani, Microsoft |
| Correo Electrónico | jayjani@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Jay Jani |
| Sitio web | https://graph.microsoft.com |
| Directiva de privacidad | https://privacy.microsoft.com/en-us/privacystatement |
| Categorías | Operaciones de TI; Datos |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Enumerar grupos por búsqueda de nombres para mostrar |
Recuperar grupos mediante la búsqueda del nombre para mostrar del grupo |
| Enumerar miembros del grupo directo |
Recuperar miembros directos de un grupo con recuento |
| Enumerar sku suscritas |
Detalles de las SKU de plan de licencias suscritos de la organización |
| Lista de usuarios |
Recuperar todos los usuarios de la organización (inquilino de Id. de Entra de Microsoft) |
| Obtener detalles de la licencia de miembro |
Recuperación de los detalles de licencia de los miembros del grupo (usuario) |
| Obtener grupos de miembros |
Pertenencias a grupos para un usuario (miembro) |
| Obtener propiedades de grupo |
Recuperar propiedades y relaciones de un grupo de identificadores de Microsoft Entra |
Enumerar grupos por búsqueda de nombres para mostrar
Recuperar grupos mediante la búsqueda del nombre para mostrar del grupo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Buscar por nombre para mostrar
|
$search | string |
Buscar por palabra clave en el nombre para mostrar del grupo de identificadores de Microsoft Entra |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Contexto de Odata
|
@odata.context | string |
Vínculo A Odata.context. |
|
Número de grupos
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
identificación
|
value.id | string |
Id. de objeto del grupo |
|
Fecha y hora eliminadas
|
value.deletedDateTime | string |
Fecha y hora de eliminación de grupos |
|
Classification
|
value.classification | string |
Clasificación del grupo |
|
Fecha y hora de creación
|
value.createdDateTime | string |
Fecha y hora de creación de grupos |
|
creationOptions
|
value.creationOptions | array of |
Opciones creadas del grupo. |
|
Description
|
value.description | string |
Descripción del grupo |
|
Nombre de pantalla
|
value.displayName | string |
Nombre para mostrar del grupo |
|
Fecha y hora de expiración
|
value.expirationDateTime | string |
Fecha y hora de expiración del grupo |
|
groupTypes
|
value.groupTypes | array of string |
Tipos de grupo para el grupo. |
|
Se puede asignar al rol
|
value.isAssignableToRole | string |
¿Se puede asignar un rol a este grupo? |
|
Mail
|
value.mail | string |
Correo electrónico del grupo |
|
Correo habilitado
|
value.mailEnabled | boolean |
¿Está habilitado el correo electrónico de grupo? |
|
Nombre de Nick de correo
|
value.mailNickname | string |
Nombre de nick de correo electrónico del grupo |
|
Regla de pertenencia
|
value.membershipRule | string |
Regla que se usa para la evaluación de pertenencia. |
|
Estado de procesamiento de reglas de pertenencia
|
value.membershipRuleProcessingState | string |
Estado de procesamiento de la regla que se usa para la evaluación de pertenencia. |
|
OnPremises Domain Name
|
value.onPremisesDomainName | string |
Contiene el dominio localFQDN, también denominado dnsDomainName sincronizado desde el directorio local. |
|
Hora de fecha y hora de la última sincronización de OnPremises
|
value.onPremisesLastSyncDateTime | string |
Hora y fecha en la que el inquilino se sincronizó por última vez con el directorio local. |
|
OnPremises NetBios Name
|
value.onPremisesNetBiosName | string |
Nombre del servicio de red para el servidor local. |
|
OnPremises Sam Account Name
|
value.onPremisesSamAccountName | string |
Nombre de cuenta sam para el directorio local. |
|
Identificador de seguridad OnPremises
|
value.onPremisesSecurityIdentifier | string |
Identificador de seguridad local. |
|
OnPremises Sync Enabled
|
value.onPremisesSyncEnabled | boolean |
True si la sincronización local está habilitada para el grupo. |
|
Ubicación de datos preferida
|
value.preferredDataLocation | string |
Ubicación de datos preferida del grupo. |
|
Idioma preferido
|
value.preferredLanguage | string |
Idioma preferido como configurado en microsoft Entra ID. |
|
direcciones de proxy
|
value.proxyAddresses | array of string |
Direcciones de proxy del grupo. |
|
Fecha y hora renovadas
|
value.renewedDateTime | string |
Fecha y hora renovadas del grupo. |
|
resourceBehaviorOptions
|
value.resourceBehaviorOptions | array of |
Opciones de comportamiento de recursos del grupo. |
|
resourceProvisioningOptions
|
value.resourceProvisioningOptions | array of string |
Opciones de aprovisionamiento de recursos del grupo. |
|
Seguridad habilitada
|
value.securityEnabled | boolean |
Indica si el grupo está habilitado para la seguridad. |
|
Identificador de seguridad
|
value.securityIdentifier | string |
Identificador de seguridad del grupo. |
|
Tema
|
value.theme | string |
Tema del grupo de identificadores de Microsoft Entra. |
|
Visibilidad
|
value.visibility | string |
Visibilidad del grupo. |
|
onPremisesProvisioningErrors
|
value.onPremisesProvisioningErrors | array of |
Errores de aprovisionamiento local del grupo. |
Enumerar miembros del grupo directo
Recuperar miembros directos de un grupo con recuento
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de objeto del grupo de identificadores de Entra de Microsoft
|
group-id | True | string |
Id. de objeto del grupo de identificadores de Entra de Microsoft |
|
Filtrar por
|
$filter | string |
Filtrar por |
|
|
Selección de punto de datos (columna)
|
$select | string |
Selección de las columnas que se van a recuperar |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Contexto de Odata
|
@odata.context | string |
Vínculo A Odata.context. |
|
Recuento de Odata
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
Tipo de Odata
|
value.@odata.type | string |
@odata.type |
|
Nombre de pantalla
|
value.displayName | string |
Nombre completo del miembro |
|
Nombre principal del usuario
|
value.userPrincipalName | string |
Nombre principal de usuario del miembro |
|
identificación
|
value.id | string |
Id. de objeto para el miembro |
|
Título del Puesto
|
value.jobTitle | string |
título del trabajo |
|
Nombre de Nick de correo
|
value.mailNickname | string |
Nombre de nick de correo electrónico del miembro |
|
Mail
|
value.mail | string |
Correo electrónico del miembro |
|
Nombre propio
|
value.givenName | string |
Nombre del miembro |
|
Surname
|
value.surname | string |
Apellidos del miembro |
|
businessPhones
|
value.businessPhones | array of string |
businessPhones |
|
Teléfono móvil
|
value.mobilePhone | string |
mobilePhone |
|
Ubicación de Office
|
value.officeLocation | string |
officeLocation |
|
Idioma preferido
|
value.preferredLanguage | string |
Idioma preferido como configurado en microsoft Entra ID. |
Enumerar sku suscritas
Detalles de las SKU de plan de licencias suscritos de la organización
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Contexto de Odata
|
@odata.context | string |
Vínculo A Odata.context. |
|
value
|
value | array of object |
value |
|
Estado de la funcionalidad
|
value.capabilityStatus | string |
Estado de funcionalidad de la SKU |
|
Unidades consumidas
|
value.consumedUnits | integer |
¿Cuántas unidades de SKU ya se consumen? |
|
identificación
|
value.id | string |
id |
|
Identificador de SKU
|
value.skuId | string |
Identificador único global de la SKU |
|
Número de pieza de SKU
|
value.skuPartNumber | string |
Nombre de la SKU |
|
Se aplica a
|
value.appliesTo | string |
¿A quién se aplica la SKU? |
|
Enabled
|
value.prepaidUnits.enabled | integer |
Unidades habilitadas |
|
Suspendido
|
value.prepaidUnits.suspended | integer |
Unidades suspendidas |
|
Advertencia
|
value.prepaidUnits.warning | integer |
Unidades en advertencia |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisioningStatus
|
value.servicePlans.provisioningStatus | string |
provisioningStatus |
|
se aplicaA
|
value.servicePlans.appliesTo | string |
se aplicaA |
Lista de usuarios
Recuperar todos los usuarios de la organización (inquilino de Id. de Entra de Microsoft)
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
@odata.context
|
@odata.context | string |
Vínculo A Odata.context. |
|
value
|
value | array of object |
value |
|
businessPhones
|
value.businessPhones | array of string |
businessPhones |
|
Nombre de pantalla
|
value.displayName | string |
Nombre completo del usuario |
|
Nombre propio
|
value.givenName | string |
Nombre del usuario |
|
Título del Puesto
|
value.jobTitle | string |
Puesto del usuario |
|
Mail
|
value.mail | string |
Correo electrónico del usuario |
|
Teléfono móvil
|
value.mobilePhone | string |
Teléfono móvil del usuario |
|
Ubicación de Office
|
value.officeLocation | string |
Ubicación de la oficina del usuario |
|
Idioma preferido
|
value.preferredLanguage | string |
Idioma preferido del usuario |
|
Surname
|
value.surname | string |
Apellidos del usuario |
|
Nombre principal del usuario
|
value.userPrincipalName | string |
Nombre principal del usuario |
|
identificación
|
value.id | string |
Id. de objeto del usuario |
Obtener detalles de la licencia de miembro
Recuperación de los detalles de licencia de los miembros del grupo (usuario)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de objeto del miembro(usuario) de Microsoft Entra ID
|
id | True | string |
Id. de objeto del miembro(usuario) de Microsoft Entra ID |
|
Selección de puntos de datos (columnas)
|
$select | string |
Selección de puntos de datos (columnas) |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Contexto de Odata
|
@odata.context | string |
Vínculo A Odata.context. |
|
value
|
value | array of object |
value |
|
identificación
|
value.id | string |
id |
|
Identificador de SKU
|
value.skuId | string |
Identificador de la SKU. |
|
Número de pieza de SKU
|
value.skuPartNumber | string |
Nombre de la SKU |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisioningStatus
|
value.servicePlans.provisioningStatus | string |
provisioningStatus |
|
se aplicaA
|
value.servicePlans.appliesTo | string |
se aplicaA |
Obtener grupos de miembros
Pertenencias a grupos para un usuario (miembro)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de objeto del miembro(usuario) de Microsoft Entra ID
|
member-id | True | string |
Id. de objeto del miembro(usuario) de Microsoft Entra ID |
|
Solo seguridad habilitada (true/false)
|
securityEnabledOnly | True | boolean |
¿Desea recuperar solo grupos habilitados para la seguridad? |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Contexto de Odata
|
@odata.context | string |
Vínculo A Odata.context. |
|
value
|
value | array of string |
value |
Obtener propiedades de grupo
Recuperar propiedades y relaciones de un grupo de identificadores de Microsoft Entra
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de objeto del grupo de identificadores de Entra de Microsoft
|
group-id | True | string |
Id. de objeto del grupo de identificadores de Entra de Microsoft |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Contexto de Odata
|
@odata.context | string |
Vínculo A Odata.context. |
|
identificación
|
id | string |
Id. de objeto del grupo |
|
Fecha y hora eliminadas
|
deletedDateTime | string |
Fecha y hora de eliminación del grupo |
|
Classification
|
classification | string |
clasificación |
|
Fecha y hora de creación
|
createdDateTime | string |
Fecha y hora de creación del grupo |
|
creationOptions
|
creationOptions | array of string |
Opciones creadas del grupo. |
|
Description
|
description | string |
descripción |
|
Nombre de pantalla
|
displayName | string |
Nombre para mostrar del grupo |
|
Fecha y hora de expiración
|
expirationDateTime | string |
Fecha y hora de expiración del grupo |
|
groupTypes
|
groupTypes | array of string |
Tipos de grupo para el grupo. |
|
Se puede asignar al rol
|
isAssignableToRole | string |
¿Se puede asignar un rol a este grupo? |
|
Mail
|
string |
Correo electrónico del grupo |
|
|
Correo habilitado
|
mailEnabled | boolean |
¿Está habilitado el correo electrónico de grupo? |
|
Nombre de Nick de correo
|
mailNickname | string |
Nombre de nick de correo electrónico del grupo |
|
Regla de pertenencia
|
membershipRule | string |
Regla que se usa para la evaluación de pertenencia. |
|
Estado de procesamiento de reglas de pertenencia
|
membershipRuleProcessingState | string |
Estado de procesamiento de la regla que se usa para la evaluación de pertenencia. |
|
OnPremises Domain Name
|
onPremisesDomainName | string |
Contiene el dominio localFQDN, también denominado dnsDomainName sincronizado desde el directorio local. |
|
Hora de fecha y hora de la última sincronización de OnPremises
|
onPremisesLastSyncDateTime | string |
Hora y fecha en la que el inquilino se sincronizó por última vez con el directorio local. |
|
OnPremises NetBios Name
|
onPremisesNetBiosName | string |
Nombre del servicio de red para el servidor local. |
|
OnPremises Sam Account Name
|
onPremisesSamAccountName | string |
Nombre de cuenta sam para el directorio local. |
|
Identificador de seguridad OnPremises
|
onPremisesSecurityIdentifier | string |
Identificador de seguridad local. |
|
OnPremises Sync Enabled
|
onPremisesSyncEnabled | boolean |
True si la sincronización local está habilitada para el grupo. |
|
Ubicación de datos preferida
|
preferredDataLocation | string |
Ubicación de datos preferida del grupo. |
|
Idioma preferido
|
preferredLanguage | string |
Idioma preferido como configurado en microsoft Entra ID. |
|
direcciones de proxy
|
proxyAddresses | array of string |
Direcciones de proxy del grupo. |
|
Fecha y hora renovadas
|
renewedDateTime | string |
Fecha y hora renovadas del grupo. |
|
resourceBehaviorOptions
|
resourceBehaviorOptions | array of string |
Opciones de comportamiento de recursos del grupo. |
|
resourceProvisioningOptions
|
resourceProvisioningOptions | array of string |
Opciones de aprovisionamiento de recursos del grupo. |
|
Seguridad habilitada
|
securityEnabled | boolean |
Indica si el grupo está habilitado para la seguridad. |
|
Identificador de seguridad
|
securityIdentifier | string |
Identificador de seguridad del grupo. |
|
Tema
|
theme | string |
Tema del grupo de identificadores de Microsoft Entra. |
|
Visibilidad
|
visibility | string |
Visibilidad del grupo. |
|
onPremisesProvisioningErrors
|
onPremisesProvisioningErrors | array of string |
Errores de aprovisionamiento local del grupo. |