Verwaiste Benutzer in SQL Server finden und reparieren
Nach einem Restore auf einem anderen Server kann sich eine Anwendung nicht mehr anmelden, obwohl Login und Datenbankbenutzer gleich heißen. Meist ist der Benutzer verwaist.
Ein Login lebt auf der Instanz, ein Benutzer in der Datenbank. Verbunden sind beide über die SID, nicht über den Namen. Passt die SID eines Benutzers zu keinem Login der Instanz, ist er verwaist: Er hat seine Rechte in der Datenbank noch, aber niemand kann sich als er anmelden. Das geschieht vor allem in drei Fällen:
- Eine Datenbank wird auf einer Instanz wiederhergestellt, auf der ihre Logins fehlen.
- Logins werden von Hand oder mit
Copy-DbaLogin -NewSidangelegt und bekommen dabei eine neue SID. - Ein Login wird gelöscht, sein Benutzer bleibt in der Datenbank.
Wie Sie Logins mit derselben SID übertragen und so die meisten Waisen vermeiden, zeigt Teil 5.
dbatools hat dafür drei Befehle: Get-DbaDbOrphanUser, Repair-DbaDbOrphanUser und Remove-DbaDbOrphanUser. In unserem Lab fand der erste alle verwaisten Benutzer. Zugeordnet wurde aber nur nach Namen, und eine Option zum Aufräumen löschte mehr, als der Name vermuten lässt, oder aus Skripten gar nichts. Diese Seite zeigt, was im Lab funktioniert hat und wo Sie nachprüfen sollten. Geprüft mit dbatools 2.9.1 am 18.11.2026 unter Windows mit zwei Instanzen auf einem Server und gegen SQL Server 2022 in einem Linux-Container (Methode). Wie Sie dbatools sicher installieren und verbinden, steht in Teil 1.
In 60 Sekunden
- Finden ist zuverlässig.
Get-DbaDbOrphanUsermeldet verwaiste SQL-Benutzer sowie Windows-Benutzer und -Gruppen. Benutzer, die bewusst ohne Login angelegt sind, meldet es nicht. - Zugeordnet wird nur nach Namen.
Repair-DbaDbOrphanUsersucht einen gleichnamigen, aktiven Login. Benutzer mit anderem Namen als ihr Login oder mit deaktiviertem Login bleiben verwaist. -RemoveNotExistinglöscht alle Reste, auch diese beiden Fälle, ohne-Force. Gelöschte Benutzer erscheinen nicht in der Ausgabe.- Aus einer Funktion aufgerufen, löscht dieselbe Option nichts, ohne Warnung und ohne Fehler.
- Vorher ansehen, danach prüfen:
Remove-DbaDbOrphanUser -WhatIfnennt die Kandidaten,Get-DbaDbOrphanUserzeigt nach jedem automatisierten Lauf, was noch da ist.
1 · Verwaiste Benutzer finden
Die Befehle dieser Seite (Hilfe und Quelltext von 2.9.1):
| Befehl | Wirkung |
|---|---|
Get-DbaDbOrphanUser | listet verwaiste Benutzer |
Repair-DbaDbOrphanUser | ordnet verwaiste Benutzer gleichnamigen Logins zu; -RemoveNotExisting löscht den Rest |
Remove-DbaDbOrphanUser | löscht verwaiste Benutzer; -Force auch solche mit gleichnamigem Login oder mit Schemas, die Objekte enthalten |
Die Datenbank kasse stammt aus dem Lab von Teil 5: ein Windows-Server mit den Instanzen SQLSRV-01 und SQLSRV-01\SQL2. In kasse gibt es die Benutzer app_leser, gesperrt (Login deaktiviert), kassierer (Login heißt alias_login), ehemalig, einen lokalen Windows-Benutzer und eine lokale Windows-Gruppe. Wir haben kasse auf SQLSRV-01\SQL2 als kasse_vorher wiederhergestellt, bevor die Logins dort waren:
Get-DbaDbOrphanUser -SqlInstance SQLSRV-01\SQL2 -Database kasse_vorher | Format-Table DatabaseName, User -AutoSizeDatabaseName User
------------ ----
kasse_vorher app_leser
kasse_vorher ehemalig
kasse_vorher gesperrt
kasse_vorher kassierer
kasse_vorher SQLSRV-01\dbt_wingruppe
kasse_vorher SQLSRV-01\dbt_winuserDer Befehl findet verwaiste SQL-Benutzer und Windows-Benutzer und -Gruppen, deren Login fehlt. Benutzer, die bewusst ohne Login angelegt sind (CREATE USER … WITHOUT LOGIN), meldet er nicht, und das ist richtig so.
Welcher Benutzer zu welchem Login gehört, zeigt eine Abfrage über die SID. Nach dem Kopieren der Logins mit Copy-DbaLogin und dem Restore von kasse sah das so aus:
-- Benutzer einer Datenbank und ihr Login laut SID (nur lesend)-- MAXDOP 1: läuft seriell und belegt keine weiteren Kerne der AnwendungSELECT dp.name AS benutzer, dp.type_desc, DATALENGTH(dp.sid) AS sid_bytes, sp.name AS login_per_sidFROM sys.database_principals AS dpLEFT JOIN sys.server_principals AS sp ON sp.sid = dp.sidWHERE dp.type IN ('S', 'U', 'G') AND dp.principal_id > 4ORDER BY dp.nameOPTION (MAXDOP 1);benutzer type_desc sid_bytes login_per_sid
-------- --------- --------- -------------
app_leser SQL_USER 16 app_leser
ehemalig SQL_USER 16
gesperrt SQL_USER 16 gesperrt
kassierer SQL_USER 16 alias_login
SQLSRV-01\dbt_wingruppe WINDOWS_GROUP 28 SQLSRV-01\dbt_wingruppe
SQLSRV-01\dbt_winuser WINDOWS_USER 28 SQLSRV-01\dbt_winuserkassierer gehört über die SID zu alias_login. ehemalig war schon auf der Quelle verwaist, sein Login gelöscht. Weil Copy-DbaLogin die SIDs mitnimmt, war hier nichts weiter zu reparieren.
2 · Zuordnen: Repair-DbaDbOrphanUser arbeitet nur mit Namen
Ist der Login nicht kopiert, sondern von Hand oder mit -NewSid angelegt, stimmen die SIDs nicht. Dann hilft Repair-DbaDbOrphanUser. Es sucht zu jedem verwaisten Benutzer einen gleichnamigen Login, der aktiv ist, und setzt die Zuordnung mit ALTER USER … WITH LOGIN (Quelltext, Zeilen 160–224). Auf SQL Server 2022, mit Logins gleichen Namens, aber anderer SID:
Repair-DbaDbOrphanUser -SqlInstance sql2022 -SqlCredential $cred -Database kasse_b| Benutzer | Login auf dem Ziel | Status |
|---|---|---|
app_leser, app_schreiber | gleichnamig, aktiv | Success |
gesperrt | gleichnamig, deaktiviert | No matching login |
kassierer | heißt alias_login | No matching login |
ehemalig | keiner | No matching login |
Ein deaktivierter Login gilt also nicht als Treffer, und ein Benutzer mit eigenem Namen findet seinen Login nicht. Beide bleiben verwaist. Das ist vorsichtig und an sich richtig. Gefährlich wird es erst mit -RemoveNotExisting.
3 · -RemoveNotExisting: vorher ansehen, danach prüfen
Mit -RemoveNotExisting löscht Repair-DbaDbOrphanUser alle Benutzer, die es nicht zuordnen konnte, samt ihren Rechten in der Datenbank. In kasse_b aus Abschnitt 2 sind das auch gesperrt, dessen Login nur deaktiviert ist, und kassierer, dessen Login nur anders heißt.
Vorher ansehen. -WhatIf an Repair sagt nicht, wen es träfe. Remove-DbaDbOrphanUser -WhatIf nennt die Benutzer:
Repair-DbaDbOrphanUser -SqlInstance sql2022 -SqlCredential $cred -Database kasse_b -RemoveNotExisting -WhatIf
Remove-DbaDbOrphanUser -SqlInstance sql2022 -SqlCredential $cred -Database kasse_b -WhatIfWhat if: Performing the operation "Remove-DbaDbOrphanUser" on target "kasse_b".
What if: Performing the operation "Dropping schema 'ehemalig'." on target "kasse_b".
What if: Performing the operation "Dropping user [ehemalig]" on target "kasse_b".
What if: Performing the operation "Dropping user [gesperrt]" on target "kasse_b".
What if: Performing the operation "Dropping user [kassierer]" on target "kasse_b".Die erste Zeile stammt von Repair, die übrigen von Remove-DbaDbOrphanUser.
Was tatsächlich geschieht. Für die Gegenprobe hatte eine Testdatenbank auf SQLSRV-01\SQL2 sechs verwaiste Benutzer: a (Login gleichen Namens, aktiv), g (Login deaktiviert), kassierer (Login heißt alias), e (kein Login, besitzt ein leeres Schema e), s (kein Login, besitzt das Schema lager mit einer Tabelle) und den Windows-Benutzer SQLSRV-01\dbt_winwaise (Windows-Konto vorhanden, Login gelöscht).
Repair-DbaDbOrphanUser -SqlInstance SQLSRV-01\SQL2 -Database orph1 -RemoveNotExisting -Confirm:$falseComputerName : SQLSRV-01
InstanceName : SQL2
SqlInstance : SQLSRV-01\SQL2
DatabaseName : orph1
User : a
Status : Success
ComputerName : SQLSRV-01
InstanceName : SQL2
SqlInstance : SQLSRV-01\SQL2
DatabaseName : orph1
SchemaName : e
Action : DROP
SchemaOwnerBefore : e
SchemaOwnerAfter : N/A
[09:21:17][Remove-DbaDbOrphanUser] Schema 'lager' owned by user s have 1 underlying objects. If you want to change the schemas' owner to 'dbo' and drop the user anyway, use -Force parameter. Skipping user '[s]'.Danach waren nur noch a und s da. a war seinem Login zugeordnet. Gelöscht waren e samt leerem Schema, g, kassierer und der Windows-Benutzer, ohne -Force. Gebremst hat den Befehl nur das Schema mit Inhalt. Mit -Force übernahm dbo das Schema lager, und s wurde ebenfalls gelöscht. Für gelöschte Benutzer gibt der Befehl kein eigenes Ergebnisobjekt aus, nur mit -Verbose erscheinen sie als „User [g] was dropped …“. Wer nur die Ausgabe liest, sieht die Löschungen nicht.
Unsere Empfehlung: Repair-DbaDbOrphanUser ohne -RemoveNotExisting laufen lassen, die Reste mit Remove-DbaDbOrphanUser -WhatIf ansehen und einzeln entscheiden. Benutzer deaktivierter Logins sind oft Absicht, etwa bei gesperrten Konten mit späterer Freigabe.
So sah der Aufruf in einer Funktion aus, mit -Verbose:
function Bereinige {
Repair-DbaDbOrphanUser -SqlInstance SQLSRV-01\SQL2 -Database orph3 -RemoveNotExisting -Confirm:$false -Verbose
}
Bereinige[09:22:22][Repair-DbaDbOrphanUser] Validating users on database '[orph3]'.
…
[09:22:23][Repair-DbaDbOrphanUser] User 'a' mapped with their login.
Performing the operation "Remove-DbaDbOrphanUser" on target "orph3".
[09:22:23][Repair-DbaDbOrphanUser] Calling 'Remove-DbaDbOrphanUser'.
[09:22:24][Remove-DbaDbOrphanUser] Validating users on database [orph3].
[09:22:24][Get-DbaDbOrphanUser] Validating users on database '[orph3]'.
[09:22:24][Get-DbaDbOrphanUser] Orphan users found
[09:22:24][Remove-DbaDbOrphanUser] No orphan users found on database [orph3].Get-DbaDbOrphanUser findet die Benutzer, Remove-DbaDbOrphanUser eine Zeile später nicht mehr. Beim direkten Aufruf steht an dieser Stelle Call origin: Repair-DbaDbOrphanUser., danach folgen die Löschungen.
Was wir gemessen haben und was nicht
- Unter Windows gemessen (18.11.2026): dbatools 2.9.1 unter Windows PowerShell 5.1 auf Windows Server 2022 mit zwei Instanzen SQL Server 2022 RTM auf demselben Server, Windows-Anmeldung. Verwaiste SQL-Benutzer, ein lokaler Windows-Benutzer und eine lokale Windows-Gruppe nach einem Restore;
-RemoveNotExistingin sechs Aufrufarten. Die VM hatte eine vCPU; Laufzeiten nennen wir deshalb nicht. - Zusätzlich gemessen (18.11.2026): dbatools 2.9.1 unter PowerShell 7.6.8 in einem Linux-Container gegen SQL Server 2022 CU27 in einem Linux-Container: Zuordnen mit
Repair-DbaDbOrphanUser,-WhatIfund-RemoveNotExistingje Aufrufebene. Je Variante ein Lauf, kleine Testdatenbanken, nur Wegwerf-Logins des Labs. - Quelltext und Issues: Die zitierten Stellen haben wir im Quelltext von 2.9.1 gelesen, nicht das ganze Modul, und am 18.11.2026 in den Issues und Pull Requests auf GitHub nach Meldungen gesucht.
- Nicht gemessen: andere Versionen als SQL Server 2022, Domänenkonten und -gruppen, zwei getrennte Windows-Server, contained Datenbanken, Kollationen mit Unterscheidung der Groß- und Kleinschreibung und Azure SQL Managed Instance.
Weiterlesen
- dbatools: Get-DbaDbOrphanUser, Repair-DbaDbOrphanUser, Remove-DbaDbOrphanUser (Hilfe mit Beispielen).
- Bei PSG: dbatools-Übersicht, Teil 1: Installieren und sicher verbinden, Teil 5: Logins und Rechte übertragen, Teil 8: Agent-Jobs und Wartungsskripte, Backup & Restore: Grundlagen.