Gebruikersaccounts beheren met de Microsoft Exchange Online Admin API

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

Ontdek de Exchange Online Admin API, een REST-gebaseerd alternatief voor Exchange Web Services (EWS). Beheer Exchange Online-gebruikersaccounts effectief.

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

Het beheren van gebruikersaccounts is cruciaal voor elke organisatie. Zo zorg je dat medewerkers de juiste toegang tot resources hebben en blijft gevoelige informatie beveiligd. De Exchange Admin API maakt dit proces eenvoudiger en efficiënter. Met de krachtige functies kun je snel gebruikersaccounts aanmaken, bijwerken of verwijderen. Daarnaast kun je er efficiënt mailboxen mee beheren. Deze API stroomlijnt je werkproces en bespaart tijd, zodat je je kunt richten op wat echt belangrijk is: je team.

Belangrijkste punten

• De Exchange Admin API vereenvoudigt het beheer van gebruikersaccounts, zodat je accounts efficiënt kunt aanmaken, bijwerken en verwijderen.

• Gebruik OAuth 2.0 voor veilige API-authenticatie. Het beschermt gebruikersreferenties doordat het toegangstokens gebruikt in plaats van wachtwoorden.

• Beveilig je toegangstokens altijd, zodat ongeautoriseerde toegang en mogelijke datalekken worden voorkomen.

• Implementeer strategieën voor foutafhandeling om veelvoorkomende problemen zoals ongeautoriseerde toegang of foutieve verzoeken effectief aan te pakken.

• Houd rekening met limieten voor aanvragen bij het gebruik van de API. Houd je gebruik in de gaten en overweeg om verzoeken te bundelen om binnen de limieten te blijven.

7 verrassende feiten over de Exchange Admin API

Als je Exchange Online beheert, kan de Exchange Admin API veranderen hoe je je omgeving automatiseert, beveiligt en monitort. Hier zijn zeven verrassende feiten over de Exchange Admin API.

1. Het biedt mailboxbeheer dat verder gaat dan Graph API. Microsoft Graph dekt veel scenario's voor gebruikers en mailboxen, maar de Exchange Admin API biedt gespecialiseerde endpoints voor Exchange-specifieke configuratie en beheer die niet in Graph beschikbaar zijn. Daarom is het de eerste keuze voor diepgaande automatisering van Exchange Online.
2. Granulaire RBAC en beheerderstoestemming zijn vereist. De API past Exchange-gerichte rolgebaseerde toegangscontroles toe en vraagt vaak om expliciete beheerderstoestemming voor gevoelige handelingen. Daarom zijn least-privilege-autorisaties en speciale service principals essentieel voor veilige automatisering.
3. Ondersteunt batch- en bulkbewerkingen voor schaalbaarheid. De Exchange Admin API maakt batchachtige en bulkbeheerpatronen mogelijk (bijvoorbeeld het bijwerken van beleid voor veel mailboxen tegelijk). Dat verkleint het aantal aanroepen aanzienlijk en vereenvoudigt beheer van grote tenants.
4. Heeft throttling en limieten op tenantniveau die afwijken van Graph. Throttlingregels en aanvraaglimieten verschillen van Microsoft Graph. Je moet retry- en backofflogica specifiek ontwerpen voor het gedrag van de Exchange Admin API, anders loop je onder belasting onverwacht tegen fouten aan.
5. Maakt geavanceerde compliance- en auditcontroles mogelijk. De API biedt Exchange-specifieke compliancefuncties, zoals mailflowregels, toewijzingen van bewaarbeleid en auditconfiguraties. Zo kun je organisatiebeleid programmatisch en op schaal afdwingen.
6. Integreert met hybride Exchange-omgevingen. Voor organisaties in hybride modus kan de Exchange Admin API naast on-premises beheertools worden gebruikt om instellingen en beleid op elkaar af te stemmen. Dat maakt migratie en coëxistentie eenvoudiger.
7. Is uit te breiden met PowerShell en moderne authenticatiestromen. Je kunt de Exchange Online PowerShell-modules en de Exchange Admin API combineren via OAuth 2.0 app-only-authenticatie of gedelegeerde stromen. Zo krijg je moderne, veilige automatisering en behoud je waar nodig de mogelijkheden van legacy PowerShell.

Gebruik de Exchange Admin API als aanvulling op Microsoft Graph en PowerShell voor robuust, schaalbaar en veilig Exchange Online-beheer.

Authenticatiemethoden

Overzicht OAuth 2.0

Wanneer je met de Exchange Admin API werkt, is kennis van OAuth 2.0 essentieel. Dit framework verhoogt de beveiliging doordat applicaties toegang tot resources kunnen krijgen zonder dat gebruikersreferenties worden blootgesteld. In plaats van wachtwoorden te delen, gebruik je toegangstokens, wat het risico op ongeautoriseerde toegang aanzienlijk verkleint. Dit zijn enkele belangrijke kenmerken van OAuth 2.0 die het een robuuste keuze maken voor API-authenticatie:

Toegangstokens verkrijgen

Om met de Exchange Admin API te werken, moet je toegangstokens verkrijgen. Hieronder vind je een eenvoudige stapsgewijze handleiding:

1. Registreer een app in Microsoft Entra ID.

2. Wijs de vereiste API-machtigingen toe.

3. Wijs RBAC-machtigingen toe.

4. Haal een toegangstoken op.

Het beveiligen van je toegangstokens is cruciaal. Als tokens niet beschermd zijn, kan dat leiden tot ernstige beveiligingsrisico's. Dit zijn enkele mogelijke gevaren van onbeveiligde toegangstokens:

• API's kunnen gevoelige gegevens blootstellen als ze niet goed worden beveiligd.

• Onbeveiligde toegangstokens kunnen leiden tot ongeautoriseerde toegang en manipulatie van gegevens.

• De toename van API-aanvallen onderstreept de noodzaak van robuuste beveiligingsmaatregelen.

Bovendien kan iemand die zich voordoet als Global Admin volledige controle krijgen over je tenant, inclusief toegang tot diensten zoals SharePoint Online en Exchange Online. Dit kan leiden tot aanzienlijke datalekken.

Volg deze stappen om Exchange Online RBAC-rollen aan applicaties toe te wijzen voor API-toegang:

1. Zorg bij gedelegeerde scenario's dat de gebruiker de nodige RBAC-rollen in Exchange Online heeft, zoals Recipient Management of Organization Management.

2. Wijs bij app-only scenario's Microsoft Entra-rollen of aangepaste Exchange RBAC-rolgroepen toe aan de service principal die je app vertegenwoordigt.

3. Gebruik de juiste OAuth 2.0-toegangstokenstroom voor je type applicatie, gedelegeerd of app-only.

4. Installeer Exchange Online PowerShell en maak er verbinding mee.

5. Maak een nieuwe service principal aan en wijs de vereiste rollen toe.

6. Controleer de roltoewijzing en test RBAC voor applicaties.

Door deze richtlijnen te volgen, kun je gebruikersaccounts effectief beheren en tegelijkertijd zorgen dat je API-interacties veilig blijven.

Gebruikersaccounts beheren met de Exchange Admin API

Gebruikersaccounts aanmaken

Gebruikersaccounts aanmaken met de Exchange Admin API is eenvoudig. Je moet specifieke velden opgeven om een nieuwe gebruiker in te stellen. Hieronder staat een korte lijst met de vereiste parameters:

• Alias: Dit is de gebruikersnaam voor het account.

• Name: De volledige naam van de gebruiker.

• FirstName: De voornaam van de gebruiker.

• LastName: De achternaam van de gebruiker.

• DisplayName: Hoe de naam van de gebruiker in de directory wordt weergegeven.

• MicrosoftOnlineServicesID: Het e-mailadres dat aan het account is gekoppeld.

• Password: Hiervoor moet je om invoer vragen.

• ResetPasswordOnNextLogon: Dit is optioneel, maar kan op true worden gezet als je wilt dat de gebruiker het wachtwoord bij de eerste aanmelding wijzigt.

Hieronder staat een eenvoudig voorbeeld van hoe je met PowerShell een gebruikersaccount kunt aanmaken:

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

Gebruikersgegevens bijwerken

Gebruikersgegevens bijwerken is net zo eenvoudig. Via de Exchange Admin API kun je verschillende kenmerken van een gebruikersaccount wijzigen. Hieronder staan enkele veelvoorkomende kenmerken die je mogelijk wilt bijwerken:

Om een gebruiker bij te werken, kun je een opdracht gebruiken zoals deze:

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

Deze opdracht werkt de weergavenaam bij van de gebruiker met de opgegeven gebruikers-ID.

Gebruikersaccounts verwijderen

Als je gebruikersaccounts wilt verwijderen, moet je een aantal stappen doorlopen om alles soepel te laten verlopen. Hier is een korte handleiding:

1. Maak verbinding met je Microsoft 365-tenant via PowerShell met de vereiste machtigingen.

2. Gebruik de opdracht Connect-MgGraph -Scopes User.Read.All, User.ReadWrite.All om de verbinding tot stand te brengen.

3. Haal de gebruikers-ID op door te filteren op de weergavenaam met Get-MgUser -Filter "displayName eq '<display name>'".

4. Verwijder het gebruikersaccount met de opdracht Remove-MgUser -UserId <userId> -Confirm:$false.

Zo beheer je gebruikersaccounts efficiënt en houd je je organisatie veilig en overzichtelijk.

Mailboxen ophalen voor effectief beheer

Het ophalen van mailboxen is cruciaal voor effectief beheer van gebruikersaccounts. Hier zijn enkele best practices om in gedachten te houden:

• Gebruik altijd POST voor alle bewerkingen, inclusief Get-*-cmdlets.

• Neem in het eindpunt alleen parameters op die door de cmdlet worden ondersteund.

• Gebruik X-AnchorMailbox voor alle bewerkingen, zodat aanvragen correct worden doorgestuurd.

• Gebruik $select om de omvang van de respons te beperken, vooral bij grote datasets.

• Combineer $select met paginering om grote hoeveelheden gegevens efficiënt te beheren.

Door deze richtlijnen te volgen, stroomlijn je het beheer van je mailboxen en zorg je ervoor dat je gebruikersaccounts altijd up-to-date zijn.

Best practices voor de Exchange Admin API

Foutafhandeling

Bij het werken met de Exchange Admin API kun je fouten tegenkomen. Weten hoe je die effectief afhandelt, scheelt je veel tijd en frustratie. Hier is een handig overzicht van veelvoorkomende foutcodes, hun oorzaken en voorgestelde oplossingen:

Door deze strategieën toe te passen, beperk je verstoringen en blijft je operatie soepel draaien.

Overwegingen bij rate limiting

Rate limiting is een ander belangrijk aspect om rekening mee te houden bij het gebruik van de Exchange Admin API. Het helpt de prestaties van de API te bewaken en zorgt voor een eerlijk gebruik door alle gebruikers. Hier zijn enkele tips om in gedachten te houden:

• De limieten begrijpen: Leer de rate limits kennen die de API oplegt. Die kennis helpt je om je aanvragen daarop af te stemmen.

• Backoff-strategieën implementeren: Als je een rate limit raakt, implementeer dan een backoff-strategie. Dit betekent dat je even wacht voordat je de aanvraag opnieuw probeert. Zo voorkom je dat je wordt geblokkeerd.

• Houd je gebruik in de gaten: Houd je API-gebruik goed in de gaten. Met monitoringtools zie je hoeveel aanvragen je doet en wanneer je de limieten nadert.

• Bundel aanvragen: Bundel je aanvragen waar dat kan. Zo verminder je het aantal calls dat je doet, en blijf je makkelijker binnen de limieten.

Door rekening te houden met rate limiting, zorg je dat je interacties met de Exchange Admin API efficiënt en effectief blijven.

Kortom: de Exchange Admin API is een krachtig hulpmiddel om gebruikersaccounts efficiënt te beheren. Je kunt accounts moeiteloos aanmaken, bijwerken en verwijderen, zodat je organisatie soepel blijft draaien. Vergeet niet dat het beveiligen van je toegangstokens en het begrijpen van foutafhandeling cruciaal zijn voor een vlotte ervaring.

Wil je dieper in de Exchange Admin API duiken? Bekijk dan deze bronnen:

• In dit artikel lees je hoe je je eerste geslaagde call naar de Exchange Online Admin API doet. Ook worden de belangrijkste gedragingen en patronen uitgelegd die voor alle endpoints gelden.

Aarzel dus niet! Ontdek de API en zie hoe die je processen voor gebruikersbeheer kan verbeteren. Veel plezier met coderen! 🚀

Veelgestelde vragen

Wat is de Exchange Admin API?

Met de Exchange Admin API beheer je gebruikersaccounts en mailboxen in Microsoft Exchange Online. Het vereenvoudigt taken zoals het aanmaken, bijwerken en verwijderen van gebruikersaccounts, waardoor beheer efficiënter wordt.

Hoe authenticeer ik mij bij de Exchange Admin API?

Je authenticeert via OAuth 2.0. Registreer je app in Microsoft Entra ID, wijs machtigingen toe en haal een toegangstoken op om veilig met de API te werken.

Kan ik het beheer van gebruikersaccounts automatiseren?

Ja! Je kunt het beheer van gebruikersaccounts automatiseren met scripts in PowerShell of andere programmeertalen. Dat bespaart tijd en vermindert handmatige fouten bij gebruikersbeheer.

Wat moet ik doen als ik een fout tegenkom?

Controleer de foutcode en raadpleeg de documentatie voor stappen om het probleem op te lossen. Veelvoorkomende problemen zijn ongeldige tokens of ontbrekende machtigingen. Pas je aanvragen daarop aan.

Hoe houd ik mijn API-gebruik in de gaten?

Je kunt je API-gebruik monitoren door logging in je applicatie te implementeren. Houd het aantal aanvragen bij en let op waarschuwingen over rate limits om verstoringen te voorkomen.

Wat is de Exchange Admin API en hoe verhoudt die zich tot Exchange Online?

De Exchange Admin API is een nieuwe REST-gebaseerde beheer-API die Microsoft heeft gelanceerd om Exchange-beheertaken voor Exchange Online en Office 365 Exchange Online mogelijk te maken. De admin API is een REST-gebaseerde aanpak die organisaties helpt om automatisering te moderniseren. Hij biedt endpoints die een afgebakende set Exchange-cmdlets en -parameters uitvoeren voor veelvoorkomende beheerscenario's die voorheen via EWS of Exchange Online PowerShell werden afgehandeld.

Is de Exchange Admin API een vervanging van Exchange Web Services (EWS)?

De nieuwe API is geen directe één-op-één vervanging voor alle EWS-scenario's, maar is bedoeld om organisaties op termijn weg te helpen bij EWS. Microsoft heeft uitfasering-tijdlijnen en richtlijnen aangekondigd, zoals de uitfasering van bepaalde EWS-scenario's in oktober 2026. De admin API-openbare preview en de admin API in openbare preview bieden REST-API-alternatieven voor veel Exchange-beheerscenario's en moderniseren automatisering.

Welke beheertaken worden ondersteund door de admin API-endpoints?

De API ondersteunt een beperkte set Exchange Online-beheertaken, gericht op Exchange-beheertaken zoals het beheren van geaccepteerde domeinen, mailboxfolderpermission-instellingen, delegate- en machtigingstoewijzingen en andere Exchange-beheertaken. De admin API is een REST-gebaseerde beheerinterface die is ontworpen voor veelvoorkomende Exchange-beheerscenario's en die scripting en REST-gebaseerde automatisering mogelijk maakt, naast PowerShell-cmdlets en PowerShell-scripts.

Wat betekent dit voor Office 365- en Office 365 Exchange Online-beheerders?

Voor Office 365- en Office 365 Exchange Online-beheerders biedt de preview van Exchange een route om te moderniseren met een REST-API en de afhankelijkheid van EWS-code en Exchange-cmdlets te verminderen. Beheerders kunnen admin API-endpoints gebruiken of Exchange Online PowerShell blijven gebruiken, terwijl Microsoft de beschikbare mogelijkheden van de admin API-openbare preview uitbreidt. Dit helpt organisaties om weg te migreren van EWS en moderne automatisering te gebruiken die aansluit op Microsoft 365-beheerprocessen.

Wat gebeurt er met Exchange Online PowerShell en bestaande PowerShell-cmdlets: worden die verwijderd?

Exchange Online PowerShell en PowerShell-cmdlets blijven voor veel taken een ondersteunde optie. De admin API is bedoeld als aanvulling op de Exchange-cmdlets en -parameters en biedt een REST-gebaseerd alternatief voor specifieke Exchange-beheerscenario's. Microsoft heeft een preview van de Exchange admin API beschikbaar gesteld, samen met richtlijnen voor het gebruik van zowel PowerShell-scripts als de admin API. Voor sommige scenario's blijft Exchange Online PowerShell nodig totdat de admin API-endpoints een bredere set Exchange-functionaliteit dekken.

Wanneer wordt EWS uitgefaseerd en wat moeten organisaties doen vóór oktober 2026?

Microsoft heeft in oktober 2026 de afschaffing aangekondigd voor bepaalde EWS-toepassingen en organisaties aangeraden om vanaf nu over te stappen weg van EWS voor specifieke Exchange-beheerscenario's. Beheerders moeten hun EWS-code, het gebruik van EWS voor specifieke Exchange-beheertaken en alle EWS-scenario's in hun omgeving inventariseren. Vervolgens evalueren ze de publieke preview van de admin API, de REST-API-alternatieven en Exchange Online PowerShell, zodat ze de automatisering kunnen moderniseren vóór de afschaffing in oktober 2026.

Kan de admin API mailboxmachtigingen beheren, zoals mailboxFolderPermission en delegates?

Ja, de admin API ondersteunt in veel scenario's het beheer van mailboxFolderPermission en delegatietoewijzingen. Er zijn endpoints waarmee beheerders delegatie- en machtigingsinstellingen kunnen instellen of wijzigen. De admin API biedt in eerste instantie mogelijk een beperkte set, maar is bedoeld om organisaties te helpen deze specifieke Exchange-beheertaken te automatiseren zonder uitsluitend te vertrouwen op EWS-code of Exchange-cmdlets.

Hoe krijg ik toegang tot de admin API in publieke preview en welke authenticatie is vereist?

De admin API is beschikbaar in publieke preview en vereist moderne authenticatie via het Microsoft identity platform (Azure AD/Entra). Beheerders registreren een app, verlenen de juiste scopes voor toegang tot de Exchange Online API en roepen vervolgens de REST-gebaseerde admin API-endpoints aan om Exchange-beheertaken uit te voeren. Zo kan de API worden geïntegreerd met bestaande automatisering, scripts en Microsoft 365-beheerframeworks.

Zijn er beperkingen aan de admin API tijdens de publieke preview?

Tijdens de publieke preview van de admin API kan de API een beperkte set mogelijkheden bieden in vergelijking met de volledige set Exchange-cmdlets of EWS. De preview richt zich op geschikte Exchange-beheertaken en een subset van Exchange-functies. Organisaties moeten beheerscenario's daarom valideren en hun automatisering moderniseren door admin API-endpoints te combineren met Exchange Online PowerShell waar nodig, totdat de API uitgebreidere Exchange-beheertaken ondersteunt.

Hoe moeten organisaties hun migratiestrategie van EWS naar de nieuwe REST-gebaseerde admin API plannen?

Organisaties moeten een overzicht maken van de Exchange-workloads die afhankelijk zijn van EWS, de specifieke Exchange-beheerscenario's en EWS-scenario's voor specifieke Exchange-beheerbehoeften in kaart brengen, en het migreren van automatisering met veel impact prioriteren naar de admin API of Exchange Online PowerShell. Gebruik de publieke preview van de admin API om beheerscenario's te testen en de automatisering te moderniseren, werk PowerShell-scripts en EWS-code waar nodig bij, en houd de richtlijnen van Microsoft over de afschaffing en toekomstige beschikbaarheid tot oktober 2026 en daarna bij.