Cómo gestionar cuentas de usuario con la API de administración de Exchange Online

By Mirko Peters · 2026-03-09 · Updated 2026-03-24

Explora la API de administración de Exchange Online, una alternativa basada en REST a Exchange Web Services (EWS). Gestiona de forma eficaz las cuentas de usuario de Exchange Online.

Automatically translated with AI from the original post. Read the English original

Gestionar las cuentas de usuario es fundamental para cualquier organización. Garantiza que los empleados tengan el acceso adecuado a los recursos y, al mismo tiempo, protege la información confidencial. La API de administración de Exchange hace este proceso más sencillo y eficiente. Gracias a sus potentes funciones, puedes crear, actualizar o eliminar cuentas de usuario con rapidez. Además, te permite gestionar los buzones de correo de forma eficaz. Esta API agiliza tu flujo de trabajo y te ahorra tiempo, para que puedas centrarte en lo que realmente importa: tu equipo.

Puntos clave

• La API de administración de Exchange simplifica la gestión de cuentas de usuario, lo que te permite crear, actualizar y eliminar cuentas de forma eficiente.

• Usa OAuth 2.0 para una autenticación segura en la API. Protege las credenciales de los usuarios mediante tokens de acceso en lugar de contraseñas.

• Protege siempre tus tokens de acceso para evitar accesos no autorizados y posibles filtraciones de datos.

• Implementa estrategias de gestión de errores para abordar de forma eficaz problemas habituales, como los accesos no autorizados o las solicitudes incorrectas.

• Ten en cuenta los límites de frecuencia al usar la API. Supervisa tu uso y considera agrupar las solicitudes para mantenerte dentro de los límites.

7 datos sorprendentes sobre la API de administración de Exchange

Si gestionas Exchange Online, la API de administración de Exchange puede cambiar la forma en que automatizas, proteges y supervisas tu entorno. Estos son siete datos sorprendentes sobre la API de administración de Exchange.

1. Expone la gestión de buzones más allá de Graph API. Aunque Microsoft Graph cubre muchos escenarios de usuarios y buzones, la API de administración de Exchange ofrece puntos de conexión especializados para la configuración y la gestión específicas de Exchange que no están disponibles en Graph, por lo que es la opción ideal para una automatización avanzada de Exchange Online.
2. Se requieren RBAC granular y consentimiento de administrador. La API aplica controles de acceso basados en roles centrados en Exchange y, con frecuencia, requiere consentimiento explícito del administrador para las operaciones sensibles, por lo que el ámbito de privilegios mínimos y las entidades de servicio dedicadas son esenciales para una automatización segura.
3. Admite operaciones por lotes y masivas a gran escala. La API de administración de Exchange permite patrones de gestión por lotes y masivos (por ejemplo, actualizar directivas en muchos buzones), lo que reduce considerablemente el número de llamadas y simplifica la gestión de inquilinos a gran escala.
4. Tiene limitaciones y restricciones de nivel de inquilino distintas a las de Graph. Las reglas de limitación y los límites de solicitudes son diferentes de los de Microsoft Graph; debes diseñar una lógica de reintentos y retroceso específica para el comportamiento de la API de administración de Exchange, para evitar errores inesperados con carga elevada.
5. Habilita controles avanzados de cumplimiento y auditoría. La API expone funciones de cumplimiento específicas de Exchange, como reglas de flujo de correo, asignaciones de directivas de retención y configuraciones de auditoría, lo que permite aplicar de forma programática las directivas de la organización a gran escala.
6. Se integra con configuraciones híbridas de Exchange. En las organizaciones en modo híbrido, la API de administración de Exchange puede utilizarse junto con las herramientas de administración locales para coordinar la configuración y las directivas, lo que facilita los escenarios de migración y coexistencia.
7. Puede ampliarse con PowerShell y flujos de autenticación modernos. Puedes combinar los módulos de PowerShell de Exchange Online y la API de administración de Exchange mediante autenticación OAuth 2.0 solo de aplicación o flujos delegados, lo que permite una automatización moderna y segura, a la vez que conserva las capacidades heredadas de PowerShell cuando sea necesario.

Usa la API de administración de Exchange como complemento de Microsoft Graph y PowerShell para una gestión de Exchange Online sólida, escalable y segura.

Métodos de autenticación

Información general sobre OAuth 2.0

Cuando trabajes con la Exchange Admin API, entender OAuth 2.0 es esencial. Este marco mejora la seguridad al permitir que las aplicaciones accedan a los recursos sin exponer las credenciales del usuario. En lugar de compartir contraseñas, usas tokens de acceso, lo que reduce significativamente el riesgo de accesos no autorizados. Estas son algunas características clave de OAuth 2.0 que lo convierten en una opción sólida para la autenticación de API:

Obtención de tokens de acceso

Para interactuar con la Exchange Admin API, necesitas obtener tokens de acceso. Aquí tienes una guía sencilla paso a paso que te ayudará en el proceso:

1. Registra una aplicación en Microsoft Entra ID.

2. Asigna los permisos de API necesarios.

3. Asigna los permisos de RBAC.

4. Obtén un token de acceso.

Proteger tus tokens de acceso es fundamental. Si los tokens no están protegidos, pueden provocar riesgos de seguridad graves. Estos son algunos de los peligros potenciales de los tokens de acceso no protegidos:

• Las API pueden exponer datos sensibles si no se protegen adecuadamente.

• Los tokens de acceso no protegidos pueden provocar accesos no autorizados y la manipulación de datos.

• El aumento de los ataques contra API pone de manifiesto la necesidad de medidas de seguridad sólidas.

Además, si alguien suplanta a un administrador global, podría obtener el control total de tu inquilino, incluido el acceso a servicios como SharePoint Online y Exchange Online. Esto podría derivar en brechas de datos significativas.

Para asignar roles de RBAC de Exchange Online a las aplicaciones para el acceso a la API, sigue estos pasos:

1. En escenarios delegados, asegúrate de que el usuario tenga asignados los roles de RBAC necesarios en Exchange Online, como Administración de destinatarios o Administración de la organización.

2. En escenarios solo de aplicación, asigna roles de Microsoft Entra o grupos de roles de RBAC de Exchange personalizados a la entidad de servicio que representa tu aplicación.

3. Usa el flujo de token de acceso OAuth 2.0 adecuado para tu tipo de aplicación, ya sea delegado o solo de aplicación.

4. Instala Exchange Online PowerShell y conéctate a él.

5. Crea una nueva entidad de servicio y asigna los roles necesarios.

6. Verifica la asignación de roles y prueba RBAC para las aplicaciones.

Siguiendo estas pautas, puedes gestionar las cuentas de usuario de forma eficaz y, al mismo tiempo, mantener segura tu interacción con las API.

Gestión de cuentas de usuario con la Exchange Admin API

Creación de cuentas de usuario

Crear cuentas de usuario con la Exchange Admin API es sencillo. Necesitas proporcionar los campos específicos para configurar un nuevo usuario. Esta es una lista rápida de los parámetros obligatorios:

• Alias: es el nombre de usuario de la cuenta.

• Name: el nombre completo del usuario.

• FirstName: el nombre de pila del usuario.

• LastName: los apellidos del usuario.

• DisplayName: cómo aparece el nombre del usuario en el directorio.

• MicrosoftOnlineServicesID: la dirección de correo electrónico asociada a la cuenta.

• Password: deberás solicitar este dato al usuario.

• ResetPasswordOnNextLogon: es opcional, pero puede establecerse en true si quieres que el usuario cambie su contraseña en el primer inicio de sesión.

Este es un ejemplo sencillo de cómo podrías crear una cuenta de usuario con PowerShell:

New-MgUser -AccountEnabled $true -DisplayName "Holly Holt" -MailNickname "hollyh" -UserPrincipalName "hollyh@corp.contoso.com" -PasswordProfile @{ForceChangePasswordNextSignIn=$true; Password="YourSecurePassword"}

Actualización de la información de los usuarios

Actualizar la información de los usuarios es igual de sencillo. Puedes modificar diversos atributos de una cuenta de usuario mediante la Exchange Admin API. Estos son algunos atributos habituales que podrías querer actualizar:

Para actualizar un usuario, puedes usar un comando como este:

Update-MgUser -UserId "<userId>" -DisplayName "Holly Holt Updated"

Este comando actualiza el nombre para mostrar del usuario con el identificador de usuario especificado.

Eliminación de cuentas de usuario

Al eliminar cuentas de usuario, debes seguir algunos pasos para que todo salga bien. Aquí tienes una guía rápida:

1. Conéctate a tu inquilino de Microsoft 365 mediante PowerShell con los permisos necesarios.

2. Usa el comando Connect-MgGraph -Scopes User.Read.All, User.ReadWrite.All para establecer la conexión.

3. Obtén el identificador del usuario filtrando por nombre para mostrar con Get-MgUser -Filter "displayName eq '<display name>'".

4. Elimina la cuenta de usuario con el comando Remove-MgUser -UserId <userId> -Confirm:$false.

Este proceso te permite gestionar las cuentas de usuario de forma eficiente, manteniendo tu organización segura y ordenada.

Consulta de buzones para una gestión eficaz

Consultar buzones es fundamental para una gestión eficaz de las cuentas de usuario. Estas son algunas buenas prácticas que conviene tener en cuenta:

• Usa siempre POST en todas las operaciones, incluidos los cmdlets Get-*.

• Incluye en el endpoint solo los parámetros que admite el cmdlet.

• Usa X-AnchorMailbox en todas las operaciones para asegurar que las solicitudes se enruten correctamente.

• Utiliza $select para reducir el tamaño de la respuesta, especialmente cuando trabajas con grandes volúmenes de datos.

• Combina $select con la paginación para gestionar datos extensos de forma eficiente.

Siguiendo estas pautas, podrás agilizar la gestión de buzones y mantener tus cuentas de usuario siempre actualizadas.

Buenas prácticas para la API de administración de Exchange

Gestión de errores

Al trabajar con la API de administración de Exchange, puedes encontrarte con errores. Saber cómo gestionarlos con eficacia puede ahorrarte tiempo y frustración. Aquí tienes una tabla práctica con los códigos de error más comunes, sus causas y las soluciones sugeridas:

Con estas estrategias, podrás minimizar las interrupciones y mantener tus operaciones funcionando sin contratiempos.

Consideraciones sobre la limitación de velocidad

La limitación de velocidad (rate limiting) es otro aspecto importante al usar la API de administración de Exchange. Ayuda a mantener el rendimiento de la API y garantiza un uso equitativo entre todos los usuarios. Estos son algunos consejos que conviene tener en cuenta:

• Conoce los límites: familiarízate con los límites de velocidad que impone la API. Este conocimiento te ayuda a planificar tus solicitudes en consecuencia.

• Implementa estrategias de backoff: si alcanzas un límite de velocidad, aplica una estrategia de backoff. Esto significa esperar un poco antes de reintentar la solicitud. Así puedes evitar que te bloqueen.

• Supervisa tu uso: Vigila el uso que haces de la API. Las herramientas de supervisión pueden ayudarte a controlar cuántas solicitudes realizas y cuándo te acercas a los límites.

• Agrupa las solicitudes en lotes: Si es posible, envía tus solicitudes por lotes. Así reduces el número de llamadas que haces y te resulta más fácil mantenerte dentro de los límites.

Si tienes en cuenta la limitación de frecuencia (rate limiting), podrás asegurarte de que tus interacciones con la Exchange Admin API sigan siendo eficientes y eficaces.

En resumen, la Exchange Admin API es una herramienta potente para gestionar cuentas de usuario con eficacia. Puedes crear, actualizar y eliminar cuentas con facilidad, lo que garantiza que tu organización funcione sin problemas. Recuerda que proteger tus tokens de acceso y entender el manejo de errores son claves para una experiencia fluida.

Para profundizar en la Exchange Admin API, considera estos recursos:

• Este artículo te guía para realizar tu primera llamada correcta a la Exchange Online Admin API y explica los comportamientos y patrones clave aplicables a todos los endpoints.

¡No lo dudes! Explora la API y descubre cómo puede mejorar tus procesos de gestión de usuarios. ¡Feliz programación! 🚀

Preguntas frecuentes

¿Qué es la Exchange Admin API?

La Exchange Admin API te permite gestionar cuentas de usuario y buzones en Microsoft Exchange Online. Simplifica tareas como crear, actualizar y eliminar cuentas de usuario, lo que hace la administración más eficiente.

¿Cómo me autentico con la Exchange Admin API?

Te autenticas con OAuth 2.0. Registra tu aplicación en Microsoft Entra ID, asigna permisos y obtén un token de acceso para interactuar con la API de forma segura.

¿Puedo automatizar la gestión de cuentas de usuario?

¡Sí! Puedes automatizar la gestión de cuentas de usuario mediante scripts con PowerShell u otros lenguajes de programación. Esto ahorra tiempo y reduce los errores manuales en la administración de usuarios.

¿Qué debo hacer si encuentro un error?

Revisa el código de error y consulta la documentación para ver los pasos de solución de problemas. Entre los problemas más comunes están los tokens no válidos y los permisos que faltan. Ajusta tus solicitudes en consecuencia.

¿Cómo puedo supervisar el uso de la API?

Puedes supervisar el uso de la API implementando registros (logging) en tu aplicación. Registra el número de solicitudes realizadas y vigila las advertencias de limitación de frecuencia para evitar interrupciones.

¿Qué es la Exchange Admin API y qué relación tiene con Exchange Online?

La Exchange Admin API es una nueva API administrativa basada en REST que Microsoft ha lanzado para habilitar tareas administrativas de Exchange en Exchange Online y Office 365 Exchange Online. Está diseñada para ayudar a las organizaciones a modernizar la automatización y ofrece endpoints que realizan un conjunto concreto de cmdlets y parámetros de Exchange para escenarios de administración habituales que antes se gestionaban con EWS o con Exchange Online PowerShell.

¿La Exchange Admin API sustituye a Exchange Web Services (EWS)?

La nueva API no es un reemplazo directo uno a uno para todos los escenarios de EWS, pero está pensada para ayudar a las organizaciones a dejar EWS con el tiempo. Microsoft ha anunciado calendarios de retirada, como la retirada prevista en octubre de 2026 para ciertos escenarios de EWS. La Exchange Admin API en versión preliminar pública ofrece alternativas REST para muchos escenarios de administración de Exchange y moderniza la automatización.

¿Qué tareas administrativas admiten los endpoints de la Exchange Admin API?

La API admite un conjunto limitado de tareas administrativas de Exchange Online, centradas en la gestión de dominios aceptados, los permisos de carpeta de buzón (mailboxfolderpermission), la asignación de delegados y de permisos, entre otras tareas administrativas de Exchange. Es una superficie administrativa basada en REST, diseñada para escenarios habituales de administración de Exchange y para habilitar la automatización REST junto a los cmdlets y scripts de PowerShell.

¿Cómo afecta esto a los administradores de Office 365 y Office 365 Exchange Online?

Para los administradores de Office 365 y Office 365 Exchange Online, la versión preliminar de Exchange ofrece una vía para modernizarse con una API REST y reducir la dependencia del código EWS y de los cmdlets de Exchange. Los administradores pueden usar los endpoints de la Exchange Admin API o seguir usando Exchange Online PowerShell mientras Microsoft amplía las capacidades de la versión preliminar pública de la API. Esto ayuda a las organizaciones a migrar desde EWS y a adoptar una automatización moderna que se integra con los flujos de trabajo de gestión de Microsoft 365.

¿Qué pasa con Exchange Online PowerShell y los cmdlets de PowerShell existentes? ¿Se eliminarán?

Exchange Online PowerShell y los cmdlets de PowerShell siguen siendo una opción compatible para muchas tareas. La admin api pretende complementar los cmdlets y parámetros de Exchange ofreciendo una alternativa basada en REST para escenarios concretos de administración de Exchange. Microsoft ha publicado una versión preliminar de la admin api y una guía para usar tanto scripts de PowerShell como la admin api. Algunos escenarios seguirán necesitando Exchange Online PowerShell hasta que los endpoints de la admin api cubran un conjunto más amplio de la funcionalidad de Exchange.

¿Cuándo se retirará EWS y qué deberían hacer las organizaciones antes de octubre de 2026?

Microsoft anunció la retirada en octubre de 2026 de determinados usos de EWS y recomendó a las organizaciones que planifiquen la migración para alejarse de EWS en escenarios concretos de administración de Exchange. Los administradores deberían inventariar el código EWS, los usos de EWS para tareas específicas de administración de Exchange y cualquier otro escenario de EWS en su entorno. Después, deberían evaluar la versión preliminar pública de la admin api, las alternativas de API REST y Exchange Online PowerShell para modernizar la automatización antes de la retirada en octubre de 2026.

¿Puede la admin api gestionar permisos de buzón como mailboxfolderpermission y delegados?

Sí, la admin api admite la gestión de mailboxfolderpermission y de las asignaciones de delegados en muchos escenarios, con endpoints que permiten a los administradores definir o modificar la configuración de delegados y permisos. Aunque la admin api puede ofrecer inicialmente un conjunto limitado, está diseñada para ayudar a las organizaciones a automatizar estas tareas administrativas concretas de Exchange sin depender únicamente de código EWS o de cmdlets de Exchange.

¿Cómo accedo a la admin api en versión preliminar pública y qué autenticación se necesita?

La admin api está disponible en versión preliminar pública y requiere autenticación moderna a través de Microsoft identity platform (Azure AD/Entra). Los administradores registran una aplicación, conceden los scopes adecuados para acceder a la API de Exchange Online y llaman a los endpoints REST de la admin api para realizar tareas de administración de Exchange. Este enfoque permite integrarla con la automatización existente, los scripts y los marcos de gestión de Microsoft 365.

¿Tiene limitaciones la admin api durante la versión preliminar pública?

Durante la versión preliminar pública de la admin api, es posible que la API ofrezca un conjunto de funciones más limitado que el conjunto completo de cmdlets de Exchange o de EWS. La preview se centra en tareas administrativas adecuadas de Exchange y en un subconjunto de funciones de Exchange. Las organizaciones deberían validar sus escenarios de administración y modernizar la automatización combinando los endpoints de la admin api con Exchange Online PowerShell cuando sea necesario, hasta que la API admita tareas de administración de Exchange más amplias.

¿Cómo deberían planificar las organizaciones su estrategia de migración de EWS a la nueva admin api basada en REST?

Las organizaciones deberían revisar las cargas de trabajo de Exchange que dependen de EWS, identificar los escenarios de administración de Exchange y los escenarios de EWS para necesidades concretas de administración, y priorizar la migración de la automatización de mayor impacto a la admin api o a Exchange Online PowerShell. Usa la versión preliminar pública de la admin api para probar escenarios de administración y modernizar la automatización, actualiza los scripts de PowerShell y el código EWS cuando proceda, y sigue la guía de Microsoft sobre la retirada y la disponibilidad futura hasta octubre de 2026 y más allá.