Notedraft
Offboarding in Microsoft 365 mit PowerShell und Microsoft Graph
This post is only available in German so far. You are reading the original.
Verlässt jemand die Organisation, sollen in kurzer Zeit mehrere Dinge passieren: Die Anmeldung wird gesperrt, laufende Sitzungen enden, das Postfach bleibt für Kollegen erreichbar, Lizenzen werden frei und Gruppenmitgliedschaften verschwinden. Von Hand im Admin Center vergisst man dabei leicht einen Schritt. Ein kurzes Skript macht es jedes Mal gleich.
Hintergrund: welches Modul
Viele ältere Anleitungen nutzen die Module MSOnline und AzureAD. Microsoft hat beide zum 30. März 2024 abgekündigt, zugesagt war der Betrieb nur bis 30. März 2025. Der Ersatz ist das Microsoft Graph PowerShell SDK (Cmdlets mit Mg im Namen). Für das Postfach braucht es zusätzlich das Exchange Online PowerShell-Modul mit Connect-ExchangeOnline.
Drei Details bestimmen die Reihenfolge im Skript:
- Sperren wirkt nicht sofort. Laut Microsoft kann die Kontosperre bis zu 24 Stunden brauchen, und ein ausgestelltes Zugriffstoken gilt bis zu einer Stunde. Deshalb widerruft das Skript zusätzlich alle Sitzungen.
Revoke-MgUserSignInSessionmacht alle Aktualisierungstoken und Sitzungscookies ungültig. - Die Umwandlung braucht die Lizenz. Ein Benutzerpostfach lässt sich nur in ein freigegebenes Postfach umwandeln, solange ihm noch eine Lizenz zugewiesen ist. Erst danach darf die Lizenz weg. Ohne Lizenz ist ein freigegebenes Postfach auf 50 GB begrenzt, und für einen Litigation Hold braucht es weiterhin eine passende Exchange-Lizenz. Das Benutzerkonto selbst darfst du nicht löschen, es verankert das freigegebene Postfach.
- Geerbte Lizenzen lassen sich nicht direkt entfernen. Kommt eine Lizenz über eine Gruppe, entfernt Entra ID sie, sobald der Benutzer die Gruppe verlässt. Mit
Set-MgUserLicenseentfernst du nur direkt zugewiesene Lizenzen.
Bei Gruppen gibt es zwei Grenzen: Aus dynamischen Gruppen kann man niemanden per Hand entfernen, die Regel entscheidet. Und E-Mail-aktivierte Sicherheitsgruppen sowie Verteilergruppen sind in Microsoft Graph nur lesbar, die pflegst du in Exchange Online.
Lösung: das Skript
Das Skript ist für reine Cloud-Konten gedacht. Bei Konten, die aus einem lokalen Active Directory synchronisiert werden, löschst du das Konto laut Microsoft im lokalen AD und stellst es auch dort wieder her, nicht in Microsoft 365. Teste es zuerst mit einem Testkonto.
# Benötigt: Microsoft.Graph und ExchangeOnlineManagement
$upn = "benutzer@contoso.com"
Connect-MgGraph -Scopes "User.ReadWrite.All", "GroupMember.ReadWrite.All", "LicenseAssignment.ReadWrite.All"
$user = Get-MgUser -UserId $upn -Property Id, DisplayName, LicenseAssignmentStates
# 1. Anmeldung sperren und alle Sitzungen widerrufen
Update-MgUser -UserId $user.Id -AccountEnabled:$false
Revoke-MgUserSignInSession -UserId $user.Id
# 2. Postfach umwandeln, solange noch eine Lizenz zugewiesen ist
Connect-ExchangeOnline -UserPrincipalName "admin@contoso.com"
Set-Mailbox -Identity $upn -Type Shared
# 3. Aus allen Gruppen entfernen, die Graph verwalten darf
$gruppen = Get-MgUserMemberOfAsGroup -UserId $user.Id -All -Property Id, DisplayName, GroupTypes, MailEnabled
foreach ($g in $gruppen) {
$dynamisch = $g.GroupTypes -contains "DynamicMembership"
$nurExchange = $g.MailEnabled -and -not ($g.GroupTypes -contains "Unified")
if ($dynamisch -or $nurExchange) {
Write-Warning "Übersprungen, bitte von Hand prüfen: $($g.DisplayName)"
continue
}
Remove-MgGroupMemberDirectoryObjectByRef -GroupId $g.Id -DirectoryObjectId $user.Id
}
# 4. Direkt zugewiesene Lizenzen entfernen (geerbte entfallen mit dem Austritt aus der Gruppe)
$direkt = $user.LicenseAssignmentStates |
Where-Object { -not $_.AssignedByGroup } |
Select-Object -ExpandProperty SkuId -Unique
if ($direkt) {
Set-MgUserLicense -UserId $user.Id -AddLicenses @() -RemoveLicenses @($direkt)
}
Ein paar Hinweise zum Skript:
- Die Beispiele von Microsoft geben
-AddLicenses @()auch beim reinen Entfernen mit. Daran halte ich mich. - Bevor Schritt 4 läuft, sollte das Postfach unter 50 GB liegen, sonst fehlt nach dem Entfernen der Lizenz Speicher.
- Für rollenzuweisbare Gruppen schlägt Schritt 3 mit diesen Rechten fehl, dort reicht
GroupMember.ReadWrite.Allnicht. Dafür braucht es zusätzlichRoleManagement.ReadWrite.Directoryund mindestens die Rolle Administrator für privilegierte Rollen. - Das Sperren ist eine sensible Aktion. Für normale Benutzer reicht mindestens Benutzeradministrator. Andere Admins abmelden darf laut Microsoft nur ein Globaler Administrator.
Was das Skript bewusst nicht macht: Kennwort zurücksetzen, mobile Geräte löschen und Zugriff auf OneDrive übergeben. Microsoft empfiehlt das Zurücksetzen des Kennworts ausdrücklich, weil es sofort wirkt und weil sonst Benutzername und Kennwort weiterhin auf das freigegebene Postfach passen. Diese Schritte erledige ich im Admin Center, weil dort ohnehin entschieden werden muss, wer das Postfach und die Daten übernimmt.
Fazit
Die Reihenfolge ist der eigentliche Kern: erst sperren und Sitzungen widerrufen, dann das Postfach umwandeln, solange die Lizenz noch da ist, dann Gruppen und zuletzt die direkten Lizenzen entfernen. Gruppen, die das Skript überspringt, landen als Warnung in der Ausgabe und werden von Hand nachgezogen.
Quellen
- Remove a former employee: Overview (Microsoft Learn, Stand 19.11.2026)
- Step 1: Prevent user sign-in and block access to Microsoft 365 (Microsoft Learn, Stand 19.11.2026)
- Convert a user mailbox to a shared mailbox (Microsoft Learn, Stand 28.04.2026)
- Azure AD PowerShell overview (Microsoft Learn, Hinweis zur Abkündigung)
- Revoke-MgUserSignInSession (Microsoft Learn, Stand 02.10.2026)
- Update-MgUser (Microsoft Learn)
- Set-MgUserLicense (Microsoft Learn, Stand 02.10.2026)
- Get-MgUserMemberOfAsGroup (Microsoft Learn)
- Remove member (Graph API, PowerShell-Beispiel Remove-MgGroupMemberDirectoryObjectByRef) (Microsoft Learn, Stand 23.07.2025)
- Manage Groups in Microsoft Graph (Microsoft Learn, Stand 09.07.2026)
- PowerShell examples for group-based licensing (Microsoft Learn, Stand 02.07.2026)
- Set-Mailbox und Connect-ExchangeOnline (Microsoft Learn)
More notes
- NoteLizenzen über Gruppen zuweisen: gruppenbasierte Lizenzierung in Entra IDWer Microsoft-365-Lizenzen pro Benutzer zuweist, pflegt jede Lizenz an jedem Konto von Hand. Bei jedem Eintritt, Abteilungswechsel und Austritt muss jemand daran denken. Mit gruppenbasierter Lizenzierung hängt die Lizenz an einer Gruppe: Wer Mitglied wird, bekommt sie, wer die Gruppe verlässt, verliert sie wieder.
- GuideM365 onboarding and offboardingSet up new employees in Microsoft 365 properly and remove them properly when they leave. With groups, licenses, MFA, PowerShell and a checklist for small and medium-sized companies.
- NoteConditional Access einführen, ohne sich auszusperrenConditional Access ist mächtig, und genau das macht es riskant. Eine einzige Richtlinie mit „Alle Benutzer, alle Ressourcen, Zugriff blockieren“ sperrt die ganze Organisation aus, die Admins eingeschlossen. Die meisten Probleme entstehen nicht durch exotische Einstellungen, sondern weil eine Richtlinie direkt scharf geschaltet wird, ohne sie vorher zu testen.