Comment gérer les comptes utilisateurs avec l’Exchange Online Admin API

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

Découvrez l’Exchange Online Admin API, une alternative basée sur REST aux Exchange Web Services (EWS). Gérez efficacement les comptes utilisateurs Exchange Online.

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

La gestion des comptes utilisateurs est essentielle pour toute organisation. Elle garantit que les collaborateurs disposent des bons accès aux ressources tout en protégeant les informations sensibles. L’Exchange Admin API rend ce processus plus simple et plus efficace. Grâce à ses fonctionnalités avancées, vous pouvez créer, mettre à jour ou supprimer rapidement des comptes utilisateurs. De plus, elle vous permet de gérer efficacement les boîtes aux lettres. Cette API fluidifie votre flux de travail et vous fait gagner du temps, afin que vous puissiez vous concentrer sur l’essentiel : votre équipe.

Points clés

• L’Exchange Admin API simplifie la gestion des comptes utilisateurs, en vous permettant de créer, mettre à jour et supprimer des comptes efficacement.

• Utilisez OAuth 2.0 pour une authentification sécurisée des API. Il protège les identifiants des utilisateurs en utilisant des jetons d’accès à la place des mots de passe.

• Sécurisez toujours vos jetons d’accès afin d’empêcher tout accès non autorisé et les éventuelles fuites de données.

• Mettez en place des stratégies de gestion des erreurs pour traiter efficacement les problèmes courants, tels que les accès non autorisés ou les requêtes incorrectes.

• Tenez compte des limites de débit lorsque vous utilisez l’API. Surveillez votre utilisation et envisagez de regrouper vos requêtes pour rester dans les limites.

7 faits surprenants sur l’Exchange Admin API

Si vous administrez Exchange Online, l’Exchange Admin API peut transformer la manière dont vous automatisez, sécurisez et supervisez votre environnement. Voici sept faits surprenants à son sujet.

1. Elle expose la gestion des boîtes aux lettres au-delà de l’API Graph. Si Microsoft Graph couvre de nombreux scénarios liés aux utilisateurs et aux boîtes aux lettres, l’Exchange Admin API fournit des points de terminaison spécialisés pour la configuration et la gestion propres à Exchange, absents de Graph. Elle constitue donc la référence pour une automatisation poussée d’Exchange Online.
2. Un RBAC granulaire et un consentement administrateur sont requis. L’API applique des contrôles d’accès basés sur les rôles spécifiques à Exchange et exige souvent un consentement administrateur explicite pour les opérations sensibles. Il est donc indispensable de limiter les autorisations au strict nécessaire et d’utiliser des principaux de service dédiés pour une automatisation sûre.
3. Prend en charge les opérations par lots et en masse pour passer à l’échelle. L’Exchange Admin API permet des schémas de gestion par lots et en masse (par exemple, la mise à jour de stratégies sur un grand nombre de boîtes aux lettres), ce qui réduit considérablement le nombre d’appels et simplifie la gestion de locataires de grande taille.
4. Applique au niveau du locataire un mécanisme de limitation et des quotas différents de ceux de Graph. Les règles de limitation et les quotas de requêtes sont distincts de ceux de Microsoft Graph. Vous devez donc concevoir une logique de nouvelle tentative et de temporisation (backoff) spécifique au comportement de l’Exchange Admin API, afin d’éviter des échecs inattendus en cas de charge élevée.
5. Permet des contrôles avancés de conformité et d’audit. L’API expose des fonctionnalités de conformité propres à Exchange, telles que les règles de flux de messagerie, les affectations de stratégies de rétention et les configurations d’audit, ce qui permet d’appliquer par programmation les stratégies de l’organisation à grande échelle.
6. S’intègre aux configurations Exchange hybrides. Pour les organisations en mode hybride, l’Exchange Admin API peut être utilisée conjointement avec les outils d’administration locaux pour coordonner les paramètres et les stratégies, ce qui facilite les scénarios de migration et de coexistence.
7. Peut être étendue avec PowerShell et les flux d’authentification modernes. Vous pouvez combiner les modules PowerShell d’Exchange Online et l’Exchange Admin API grâce à l’authentification OAuth 2.0 en mode application seule ou aux flux délégués. Vous bénéficiez ainsi d’une automatisation moderne et sécurisée, tout en conservant, si besoin, les capacités PowerShell héritées.

Utilisez l’Exchange Admin API en complément de Microsoft Graph et de PowerShell pour une administration d’Exchange Online robuste, évolutive et sécurisée.

Méthodes d’authentification

Présentation d’OAuth 2.0

Lorsque vous travaillez avec l’API d’administration Exchange, il est indispensable de comprendre OAuth 2.0. Ce cadre renforce la sécurité en permettant aux applications d’accéder aux ressources sans exposer les identifiants des utilisateurs. Plutôt que de partager des mots de passe, vous utilisez des jetons d’accès, ce qui réduit considérablement le risque d’accès non autorisé. Voici quelques caractéristiques clés d’OAuth 2.0 qui en font un choix robuste pour l’authentification des API :

Obtention des jetons d’accès

Pour interagir avec l’API d’administration Exchange, vous devez obtenir des jetons d’accès. Voici un guide simple, étape par étape, pour vous accompagner dans cette démarche :

1. Inscrivez une application dans Microsoft Entra ID.

2. Attribuez les autorisations d’API requises.

3. Attribuez les autorisations RBAC.

4. Obtenez un jeton d’accès.

Sécuriser vos jetons d’accès est essentiel. Si les jetons ne sont pas protégés, ils peuvent entraîner de graves risques de sécurité. Voici quelques dangers potentiels des jetons d’accès non sécurisés :

• Les API peuvent exposer des données sensibles si elles ne sont pas correctement sécurisées.

• Des jetons d’accès non sécurisés peuvent conduire à un accès non autorisé et à la manipulation des données.

• La multiplication des attaques contre les API souligne la nécessité de mesures de sécurité robustes.

De plus, si quelqu’un usurpe l’identité d’un administrateur général, il pourrait obtenir un contrôle total sur votre locataire, y compris l’accès à des services comme SharePoint Online et Exchange Online. Cela pourrait entraîner de graves fuites de données.

Pour attribuer des rôles RBAC Exchange Online aux applications afin d’accéder aux API, suivez ces étapes :

1. Pour les scénarios délégués, vérifiez que l’utilisateur dispose des rôles RBAC nécessaires dans Exchange Online, tels que Gestion des destinataires ou Gestion de l’organisation.

2. Pour les scénarios application seule, attribuez des rôles Microsoft Entra ou des groupes de rôles RBAC Exchange personnalisés au principal de service représentant votre application.

3. Utilisez le flux de jetons d’accès OAuth 2.0 approprié à votre type d’application, délégué ou application seule.

4. Installez Exchange Online PowerShell et connectez-vous à celui-ci.

5. Créez un nouveau principal de service et attribuez-lui les rôles requis.

6. Vérifiez l’attribution des rôles et testez le RBAC pour les applications.

En suivant ces recommandations, vous pouvez efficacement gérer les comptes utilisateurs tout en garantissant que vos interactions avec les API restent sécurisées.

Gestion des comptes utilisateurs avec l’API d’administration Exchange

Création de comptes utilisateurs

La création de comptes utilisateurs avec l’API d’administration Exchange est simple. Vous devez fournir les champs spécifiques permettant de configurer un nouvel utilisateur. Voici une liste rapide des paramètres obligatoires :

• Alias : il s’agit du nom d’utilisateur du compte.

• Name : le nom complet de l’utilisateur.

• FirstName : le prénom de l’utilisateur.

• LastName : le nom de famille de l’utilisateur.

• DisplayName : la façon dont le nom de l’utilisateur apparaît dans l’annuaire.

• MicrosoftOnlineServicesID : l’adresse e-mail associée au compte.

• Password : vous devrez demander cette valeur à l’utilisateur.

• ResetPasswordOnNextLogon : ce paramètre est facultatif, mais il peut être défini sur true si vous souhaitez que l’utilisateur modifie son mot de passe lors de sa première connexion.

Voici un exemple simple de création d’un compte utilisateur avec PowerShell :

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

Mise à jour des informations utilisateur

La mise à jour des informations utilisateur est tout aussi simple. Vous pouvez modifier différents attributs d’un compte utilisateur via l’API d’administration Exchange. Voici quelques attributs courants que vous pourriez vouloir mettre à jour :

Pour mettre à jour un utilisateur, vous pouvez utiliser une commande de ce type :

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

Cette commande met à jour le nom d’affichage de l’utilisateur correspondant à l’identifiant utilisateur spécifié.

Suppression des comptes utilisateur

Pour supprimer des comptes utilisateur, vous devez suivre quelques étapes afin que l’opération se déroule sans accroc. Voici un guide rapide :

1. Connectez-vous au locataire Microsoft 365 avec PowerShell, en disposant des autorisations requises.

2. Utilisez la commande Connect-MgGraph -Scopes User.Read.All, User.ReadWrite.All pour établir la connexion.

3. Récupérez l’identifiant de l’utilisateur en filtrant sur le nom d’affichage à l’aide de Get-MgUser -Filter "displayName eq '<display name>'".

4. Supprimez le compte utilisateur avec la commande Remove-MgUser -UserId <userId> -Confirm:$false.

Cette démarche vous permet de gérer efficacement les comptes utilisateur, tout en préservant la sécurité et l’organisation de votre entreprise.

Récupérer les boîtes aux lettres pour une gestion efficace

La récupération des boîtes aux lettres est essentielle à une gestion efficace des comptes utilisateur. Voici quelques bonnes pratiques à retenir :

• Utilisez toujours POST pour toutes les opérations, y compris pour les cmdlets Get-*.

• N’incluez que les paramètres pris en charge par la cmdlet dans le point de terminaison.

• Utilisez X-AnchorMailbox pour toutes les opérations afin de garantir l’acheminement correct des requêtes.

• Utilisez $select pour réduire la taille de la charge utile de la réponse, en particulier lorsque vous traitez de grands volumes de données.

• Associez $select à la pagination pour gérer efficacement les volumes de données importants.

En suivant ces recommandations, vous optimisez la gestion de vos boîtes aux lettres et vous assurez que vos comptes utilisateur sont toujours à jour.

Bonnes pratiques pour l’API d’administration Exchange

Gestion des erreurs

Lors de l’utilisation de l’API d’administration Exchange, vous pouvez rencontrer des erreurs. Savoir les gérer efficacement peut vous faire gagner du temps et vous épargner bien des frustrations. Voici un tableau pratique qui recense les codes d’erreur courants, leurs causes et les correctifs suggérés :

En appliquant ces stratégies, vous limitez les perturbations et assurez le bon fonctionnement de vos opérations.

Considérations sur la limitation du débit

La limitation du débit est un autre aspect important à prendre en compte lors de l’utilisation de l’API d’administration Exchange. Elle permet de préserver les performances de l’API et de garantir une utilisation équitable entre tous les utilisateurs. Voici quelques conseils à garder à l’esprit :

• Connaître les limites : familiarisez-vous avec les limites de débit imposées par l’API. Cette connaissance vous aide à planifier vos requêtes en conséquence.

• Mettre en œuvre une temporisation : si vous atteignez une limite de débit, appliquez une temporisation avant de relancer votre requête. Cela peut vous éviter d’être bloqué.

• Surveillez votre utilisation : suivez de près votre utilisation de l’API. Les outils de supervision vous aident à savoir combien de requêtes vous envoyez et quand vous approchez des limites.

• Regroupez vos requêtes : dans la mesure du possible, regroupez vos requêtes. Cette approche réduit le nombre d’appels et vous aide à rester dans les limites.

En tenant compte de la limitation de débit, vous garantissez que vos interactions avec l’API d’administration Exchange restent efficaces et performantes.

En résumé, l’API d’administration Exchange est un outil puissant pour gérer efficacement les comptes utilisateurs. Vous pouvez créer, mettre à jour et supprimer des comptes en toute simplicité, ce qui contribue au bon fonctionnement de votre organisation. N’oubliez pas que la sécurisation de vos jetons d’accès et la bonne gestion des erreurs sont essentielles pour une expérience fluide.

Pour approfondir l’API d’administration Exchange, consultez les ressources suivantes :

• Cet article vous guide pour réussir votre premier appel à l’API d’administration Exchange Online et explique les comportements clés et les schémas applicables à l’ensemble des points de terminaison.

Alors, n’hésitez pas ! Explorez l’API et découvrez comment elle peut améliorer vos processus de gestion des utilisateurs. Bon codage ! 🚀

Questions fréquentes

Qu’est-ce que l’API d’administration Exchange ?

L’API d’administration Exchange vous permet de gérer les comptes utilisateurs et les boîtes aux lettres dans Microsoft Exchange Online. Elle simplifie des tâches telles que la création, la mise à jour et la suppression de comptes utilisateurs, et rend l’administration plus efficace.

Comment m’authentifier auprès de l’API d’administration Exchange ?

L’authentification s’effectue via OAuth 2.0. Enregistrez votre application dans Microsoft Entra ID, attribuez les autorisations nécessaires et obtenez un jeton d’accès pour interagir avec l’API de manière sécurisée.

Puis-je automatiser la gestion des comptes utilisateurs ?

Oui ! Vous pouvez automatiser la gestion des comptes utilisateurs à l’aide de scripts PowerShell ou d’autres langages de programmation. Cela fait gagner du temps et réduit les erreurs manuelles dans l’administration des utilisateurs.

Que faire si je rencontre une erreur ?

Vérifiez le code d’erreur et consultez la documentation pour les étapes de dépannage. Les problèmes courants incluent des jetons non valides ou des autorisations manquantes. Ajustez vos requêtes en conséquence.

Comment surveiller mon utilisation de l’API ?

Vous pouvez surveiller votre utilisation de l’API en mettant en place une journalisation dans votre application. Suivez le nombre de requêtes effectuées et surveillez les avertissements de limitation de débit pour éviter toute perturbation.

Qu’est-ce que l’API d’administration Exchange et quel est son lien avec Exchange Online ?

L’API d’administration Exchange est une nouvelle API d’administration basée sur REST, lancée par Microsoft pour permettre les tâches d’administration Exchange dans Exchange Online et Office 365 Exchange Online. Cette API REST est conçue pour aider les organisations à moderniser leur automatisation. Elle propose des points de terminaison couvrant un ensemble ciblé d’applets de commande et de paramètres Exchange pour les scénarios de gestion courants, auparavant gérés avec EWS ou Exchange Online PowerShell.

L’API d’administration Exchange remplace-t-elle Exchange Web Services (EWS) ?

La nouvelle API ne remplace pas directement, point par point, tous les scénarios EWS, mais elle vise à aider les organisations à s’en éloigner progressivement. Microsoft a annoncé des calendriers de mise hors service, notamment la mise hors service de certains scénarios EWS en octobre 2026. L’API d’administration (préversion publique) fournit des alternatives REST pour de nombreux scénarios d’administration Exchange et modernise l’automatisation.

Quelles tâches d’administration les points de terminaison de l’API d’administration prennent-ils en charge ?

L’API prend en charge un ensemble limité de tâches d’administration Exchange Online, centrées sur la gestion Exchange, comme la gestion des domaines acceptés, des autorisations de dossiers de boîte aux lettres, des délégations et des attributions d’autorisations, ainsi que d’autres tâches d’administration Exchange. Il s’agit d’une interface d’administration basée sur REST, conçue pour couvrir les scénarios d’administration Exchange courants et permettre l’automatisation par script et REST, en complément des applets de commande PowerShell et des scripts PowerShell.

Quelles sont les conséquences pour les administrateurs Office 365 et Office 365 Exchange Online ?

Pour les administrateurs Office 365 et Office 365 Exchange Online, la préversion d’Exchange offre une voie de modernisation grâce à une API REST, et permet de réduire la dépendance au code EWS et aux applets de commande Exchange. Les administrateurs peuvent utiliser les points de terminaison de l’API d’administration ou continuer à utiliser Exchange Online PowerShell, pendant que Microsoft étend les capacités de l’API d’administration en préversion publique. Cela aide les organisations à migrer hors d’EWS et à adopter une automatisation moderne qui s’intègre aux flux de travail de gestion de Microsoft 365.

Qu’en est-il d’Exchange Online PowerShell et des cmdlets PowerShell existantes : seront-elles supprimées ?

Exchange Online PowerShell et les cmdlets PowerShell restent une option prise en charge pour de nombreuses tâches. L’API d’administration vise à compléter les cmdlets et paramètres Exchange en proposant une alternative REST pour des scénarios d’administration Exchange précis. Microsoft a publié un aperçu de l’API d’administration Exchange ainsi que des recommandations pour utiliser à la fois les scripts PowerShell et l’API d’administration. Certains scénarios continueront de nécessiter Exchange Online PowerShell tant que les points de terminaison de l’API d’administration ne couvriront pas un sous-ensemble plus large des fonctionnalités d’Exchange.

Quand EWS sera-t-il mis hors service et que doivent faire les organisations avant octobre 2026 ?

Microsoft a annoncé l’obsolescence de certaines utilisations d’EWS à partir d’octobre 2026 et a encouragé les organisations à prévoir leur migration hors d’EWS pour des scénarios d’administration Exchange spécifiques. Les administrateurs doivent recenser le code EWS, les usages EWS pour l’administration Exchange et tous les scénarios EWS de leur environnement, puis évaluer l’aperçu public de l’API d’administration, les alternatives API REST et Exchange Online PowerShell afin de moderniser leurs automatisations avant la fin de la prise en charge en octobre 2026.

L’API d’administration peut-elle gérer les autorisations de boîte aux lettres, comme mailboxfolderpermission et les délégués ?

Oui, l’API d’administration permet de gérer les attributions de mailboxfolderpermission et de délégués dans de nombreux scénarios, grâce à des points de terminaison qui permettent aux administrateurs de définir ou de modifier les paramètres de délégation et d’autorisation. Bien que l’API d’administration puisse proposer dans un premier temps un ensemble limité de fonctions, elle est conçue pour aider les organisations à automatiser ces tâches d’administration Exchange spécifiques sans dépendre uniquement du code EWS ni des cmdlets Exchange.

Comment accéder à l’API d’administration en aperçu public et quelle authentification est requise ?

L’API d’administration est disponible en aperçu public et nécessite une authentification moderne via la plateforme d’identité Microsoft (Azure AD/Entra). Les administrateurs enregistrent une application, accordent les étendues appropriées pour l’accès à l’API Exchange Online, puis appellent les points de terminaison REST de l’API d’administration pour effectuer la gestion d’Exchange. Cette approche permet d’intégrer l’API aux automatisations existantes, aux scripts et aux cadres de gestion de Microsoft 365.

L’API d’administration présente-t-elle des limites pendant l’aperçu public ?

Pendant l’aperçu public de l’API d’administration, celle-ci peut offrir un ensemble de fonctionnalités plus restreint que l’ensemble complet des cmdlets Exchange ou d’EWS. L’aperçu se concentre sur les tâches d’administration Exchange adaptées et un sous-ensemble de fonctions Exchange. Les organisations doivent valider leurs scénarios d’administration et moderniser leurs automatisations en combinant les points de terminaison de l’API d’administration avec Exchange Online PowerShell lorsque nécessaire, jusqu’à ce que l’API prenne en charge des tâches de gestion Exchange plus étendues.

Comment les organisations doivent-elles planifier leur stratégie de migration d’EWS vers la nouvelle API d’administration REST ?

Les organisations doivent d’abord établir un inventaire des charges de travail Exchange qui reposent sur EWS, identifier les scénarios d’administration Exchange concernés ainsi que les scénarios EWS répondant à des besoins précis d’administration Exchange, puis prioriser la migration des automatisations à fort impact vers l’API d’administration ou Exchange Online PowerShell. Utilisez l’aperçu public de l’API d’administration pour tester les scénarios d’administration et moderniser les automatisations, mettez à jour les scripts PowerShell et le code EWS si nécessaire, et suivez les recommandations de Microsoft concernant l’obsolescence et la disponibilité future, jusqu’en octobre 2026 et au-delà.