Zum Inhalt springen
Ömer Tiryaki (Startseite)
← Alle Notizen

NotizEntwurf

Offboarding in Microsoft 365 mit PowerShell und Microsoft Graph

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-MgUserSignInSession macht 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-MgUserLicense entfernst 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.All nicht. Dafür braucht es zusätzlich RoleManagement.ReadWrite.Directory und 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

Weitere Notizen

Datenschutz

Keine Tracking-Cookies

Hier wird nichts über dich gesammelt.

Das merkt sich dein Browser

Nichts davon dient der Analyse.

Zur Datenschutzerklärung