De UserPrincipalName (UPN) wijzigen in Microsoft 365 en Entra ID

De UserPrincipalName (UPN) is de aanmeldnaam van een gebruiker in Microsoft 365, zoals an.peeters@contoso.be. Je past hem aan na een fusie, een nieuwe domeinnaam, een naamswijziging of een tikfout. Voor één gebruiker kan dat in het admin center; voor tientallen of honderden gebruikers gebruik je PowerShell. In dit artikel lees je beide manieren, met de huidige Microsoft Graph PowerShell-module, en wat je vooraf moet weten.

Vooraf controleren

• Het nieuwe domein moet geverifieerd zijn in je tenant. Lees een domein toevoegen aan Microsoft 365.
• Wordt de gebruiker gesynchroniseerd vanuit Active Directory met Entra Connect, dan pas je de UPN aan in de on-premises AD. In de cloud kun je hem niet wijzigen.
• Het e-mailadres verandert niet automatisch mee. Pas ook het primaire SMTP-adres aan als dat gelijk moet blijven.
• De URL van de OneDrive van de gebruiker verandert. Gedeelde links blijven meestal werken, maar snelkoppelingen naar het oude adres niet.

Eén gebruiker: in het admin center

1. Ga naar het Microsoft 365 admin center > Gebruikers > Actieve gebruikers en klik op de gebruiker.
2. Klik onder de naam op Gebruikersnaam en e-mail beheren.
3. Klik bij de primaire gebruikersnaam op het potlood, wijzig de naam en kies het domein.
4. Klik op Gereed en daarna op Wijzigingen opslaan.

Met Microsoft Graph PowerShell

Installeer de module eenmaal, in PowerShell 7 of Windows PowerShell 5.1:

Install-Module Microsoft.Graph.Users -Scope CurrentUser

Maak verbinding met de juiste rechten. Je hebt de rol Gebruikersbeheerder of hoger nodig:

Connect-MgGraph -Scopes "User.ReadWrite.All"

Pas de UPN van één gebruiker aan:

Update-MgUser -UserId "debra.b@oudbedrijf.be" -UserPrincipalName "debra.berger@365tips.be"

Controleer het resultaat:

Get-MgUser -UserId "debra.berger@365tips.be" | Select-Object DisplayName, UserPrincipalName, Mail

Veel gebruikers tegelijk

Zet de oude en nieuwe namen in een CSV-bestand upn.csv:

OldUPN,NewUPN
an.peeters@oudbedrijf.be,an.peeters@365tips.be
tom.maes@oudbedrijf.be,tom.maes@365tips.be

En voer dit uit:

Import-Csv .\upn.csv | ForEach-Object {
    try {
        Update-MgUser -UserId $_.OldUPN -UserPrincipalName $_.NewUPN -ErrorAction Stop
        Write-Host "OK: $($_.OldUPN) -> $($_.NewUPN)"
    } catch {
        Write-Warning "Mislukt: $($_.OldUPN) - $($_.Exception.Message)"
    }
}

Wil je alle gebruikers van één domein omzetten, dan haal je ze op met Get-MgUser -All -Filter "endswith(userPrincipalName,'@oudbedrijf.be')" -ConsistencyLevel eventual -CountVariable n en vervang je het domein in de naam.

Na de wijziging

• Gebruikers melden zich voortaan aan met de nieuwe naam. Laat ze weten dat Outlook, Teams en OneDrive opnieuw kunnen vragen om aan te melden.
• Op mobiele toestellen en in de Authenticator-app kan de oude naam blijven staan tot de gebruiker zich opnieuw aanmeldt.
• Toepassingen die de UPN als vaste sleutel gebruiken, zoals sommige SaaS-apps met single sign-on, moeten de nieuwe naam ook krijgen.
• Voer de wijziging bij voorkeur buiten de werkuren uit en test eerst met één account.

Meer over Admin