dbatools: SQL Server mit PowerShell verwalten
Vierzig Instanzen auf dieselbe Einstellung prüfen, die letzten Sicherungen probehalber wiederherstellen, Logins und Jobs auf einen neuen Server ziehen: Für solche Routinearbeit gibt es seit 2015 dbatools, ein freies PowerShell-Modul mit über 700 Befehlen für SQL Server. Entstanden ist es in der SQL-Server-Gemeinschaft, und dort wird es bis heute gepflegt.
Diese Seite ordnet ein, was dbatools ist, wie Sie sicher anfangen und welche Teile der Reihe Ihnen bei welcher Aufgabe helfen. Alle Befehle, die wir zeigen, haben wir mit dbatools 2.9.1 gegen SQL Server 2017, 2019, 2022 und 2025 ausgeführt. Wie unser Testaufbau aussah und was er abdeckt, steht unter Methode und Grenzen.
In 60 Sekunden
- Ein Gemeinschaftsprojekt. dbatools ist seit Februar 2015 öffentlich, steht unter der MIT-Lizenz und hat laut Projekt über 250 Beitragende. Version 2.9.1 enthält über 700 Befehle und rund 750 Testdateien; neue Versionen erscheinen mindestens monatlich.
- Befehle nach Aufgabe.
Get-liest,Test-prüft gegen eine Regel,Copy-überträgt zwischen Instanzen,Set-ändert,Install-spielt Community-Skripte ein. Fast jeder Befehl nimmt mehrere Instanzen auf einmal. - Läuft unter Windows, Linux und macOS. Unter Linux und macOS braucht es PowerShell 7.4 oder neuer. Rund 160 Befehle brauchen Windows-Funktionen und laufen nur dort.
- Die erste Hürde ist die Verbindung. Seit Version 2 verschlüsselt dbatools jede Verbindung; das Serverzertifikat prüft es schon seit Version 1.1. Gegen Server mit selbstsigniertem Zertifikat scheitert der erste Aufruf. Wie Sie das lösen, ohne die Verschlüsselung abzuschalten, zeigt Teil 1.
- Grün deckt genau die Regel ab. Die
Test--Befehle rechnen mit dem, was SQL Server über sich selbst meldet. Weitere Instanzen auf demselben Server, andere Dienste oder Ihre Last kennen sie nicht oder nur teilweise (Teil 3). - Backups wirklich prüfen.
Test-DbaLastBackupstellt die letzte Sicherung wieder her und lässtDBCC CHECKDBlaufen. Ohne weitere Angabe tut es das auf dem Produktionsserver selbst (Teil 4).
Was dbatools ist
dbatools besteht aus zwei Modulen. dbatools enthält die Befehle, dbatools.library die .NET-Bibliotheken, auf denen sie aufbauen: SQL Server Management Objects (SMO) und den Datenbanktreiber Microsoft.Data.SqlClient. In unserem Lab waren das dbatools 2.9.1 und dbatools.library 2026.9.14 mit SqlClient 7.0 und SMO 18.100. Install-Module dbatools holt beide.
Die Befehle folgen den Verben von PowerShell. Wer das Muster kennt, findet die meisten Befehle ohne Suche:
| Verb | Was es tut | Beispiele |
|---|---|---|
Get-Dba… | liest Zustand und Konfiguration | Get-DbaDatabase, Get-DbaLastBackup, Get-DbaAgentJob |
Test-Dba… | vergleicht mit einer Regel oder probiert etwas aus | Test-DbaMaxDop, Test-DbaTempDbConfig, Test-DbaLastBackup |
Copy-Dba… | überträgt Objekte zwischen Instanzen | Copy-DbaLogin, Copy-DbaAgentJob, Copy-DbaDatabase |
Set-Dba… | ändert Einstellungen | Set-DbaMaxDop, Set-DbaMaxMemory |
Install-Dba… | spielt Community-Skripte ein | Install-DbaMaintenanceSolution, Install-DbaWhoIsActive |
Start-, Invoke- | größere Abläufe und freie Abfragen | Start-DbaMigration, Invoke-DbaQuery |
Zwei Eigenschaften machen das Modul im Alltag stark. Erstens nimmt fast jeder Befehl mit -SqlInstance eine ganze Liste von Instanzen; dieselbe Prüfung läuft dann über alle. Zweitens liefern die Befehle Objekte statt Text, die sich filtern, sortieren und als CSV oder in eine Tabelle schreiben lassen.
Ein erster Lauf im Lab sah so aus:
Import-Module dbatools
$cred = Get-Credential sa # SQL-Anmeldung; Kennwort wird abgefragt
# -TrustServerCertificate: Laborabkürzung für selbstsignierte Zertifikate, siehe Teil 1
$s = Connect-DbaInstance -SqlInstance sql2022 -SqlCredential $cred -TrustServerCertificate
Get-DbaDatabase -SqlInstance $sAuf der frischen Instanz kamen die vier Systemdatenbanken master, tempdb, model und msdb zurück. Ohne -TrustServerCertificate kam keine einzige, dafür zwei Warnungen. Warum das so ist und warum Sie dabei nicht auf eine Fehlermeldung warten sollten, steht in Teil 1.
Projekt und Gemeinschaft
dbatools ist Freiwilligenarbeit, die viele Teams im Betrieb täglich nutzen. Die Zahlen des Projekts (Stand 17.11.2026):
- Alter und Rhythmus: öffentlich seit Februar 2015; 2026 erschienen bis Oktober 15 Versionen, die jüngste ist 2.9.1 vom 15.10.2026.
- Umfang: 723 öffentliche Befehlsdateien und 752 Testdateien im Quelltext von 2.9.1; der Befehlsbrowser auf dbatools.io zählt 727 Befehle.
- Beitragende: laut Projekt über 250.
- Verbreitung: die PowerShell Gallery zählte rund 9,2 Millionen Downloads aller Versionen, davon rund 165.000 für 2.9.1.
- Lernquellen: der Befehlsbrowser mit einer Seite je Befehl, das Buch „Learn dbatools in a Month of Lunches“ von Chrissy LeMaire, Rob Sewell, Jess Pomfret und Cláudio Silva (Manning, 2022, Stand vor Version 2) und der Kanal
#dbatoolsin der SQL Community Slack.
dbatools bindet außerdem die Arbeit anderer Community-Projekte ein, statt sie nachzubauen. Install-DbaMaintenanceSolution holt Ola Hallengrens Wartungslösung, Install-DbaFirstResponderKit das First Responder Kit, Install-DbaWhoIsActive Adam Machanics sp_WhoIsActive, und Invoke-DbaDiagnosticQuery führt Glenn Berrys Diagnoseabfragen aus. Die Hilfetexte nennen die Urheber. Die drei Install--Befehle laden die Skripte aus den Projekten der Urheber auf GitHub. Glenn Berrys Abfragen liefert dbatools dagegen selbst mit; eine neuere Fassung von seiner Seite geben Sie bei Bedarf mit -Path an.
Wo wir in unseren Tests auf Verhalten gestoßen sind, das nicht zur Hilfe passt, nennen wir Version, Testaufbau und die Stelle im Quelltext. Mehrere der betroffenen Funktionen sind jung und kamen auf Wunsch aus der Gemeinschaft dazu. Stand 16.11.2026 fanden wir zu keinem dieser Befunde eine Meldung im Projekt. Einen verwandten Fehler bei -VerifyOnly haben die Maintainer bereits behoben; am 17.11.2026 war die Korrektur aber noch nicht veröffentlicht.
Vier Grundsätze für den Einsatz
- Version festhalten. Installieren Sie eine bestimmte, signierte Version und aktualisieren Sie bewusst. Unsere Befunde gelten für 2.9.1; eine neue Version kann sie ändern (Teil 1).
- Verschlüsselung nicht pauschal abschalten.
Set-DbatoolsInsecureConnectionbeseitigt die Zertifikatsfehler, schaltet aber auch die Verschlüsselung ab und gilt dauerhaft. Für Labore reicht-TrustServerCertificateje Verbindung; für Produktion gehört ein richtiges Zertifikat auf den Server (Teil 1). - Schreibende Befehle erst mit
-WhatIf, dann auf einem Testziel. Befehle, die etwas ändern, kennen-WhatIfund-Confirm. Auch lesende Befehle können Last erzeugen:Test-DbaLastBackupstellt ohne-Destinationauf der Quellinstanz wieder her (Teil 4). - Ergebnis lesen, nicht nur auf Fehler warten. Viele Befehle melden Probleme als Warnung und liefern ein leeres Ergebnis. Ein Skript, das nur auf Fehler achtet, hält „keine Verbindung“ für „keine Befunde“ (Teil 1, Teil 3).
Wo Sie anfangen
- Sie betreuen viele Instanzen: Teil 1 für Installation und Verbindung, dann Teil 3, bevor Sie Empfehlungen der
Test--Befehle übernehmen. - Sie verantworten Sicherungen: Teil 4. Strategie und Restore-Grundlagen stehen in unserer Reihe Backup & Restore.
- Sie bauen Prüfungen in Pipelines oder Container: Teil 1 und Teil 3; was SQL Server im Container von seinen Grenzen sieht, zeigt SQL Server in Docker: Was im Container schiefgeht.
- Sie fangen gerade mit dbatools an: Teil 1.
Die Reihe
dbatools installieren und sicher verbinden
„Warum scheitert schon die erste Verbindung, und wie löse ich das, ohne die Verschlüsselung abzuschalten?“
Teil 1, mit Lab unter Linux und WindowsZum Artikel →03Was Test-Dba wirklich sagt
„Kann ich die Empfehlungen für MAXDOP, Speicher und tempdb einfach übernehmen?“
Teil 3, mit Lab und AbfrageZum Artikel →04Backups wirklich wiederherstellen
„Lassen sich unsere Sicherungen wiederherstellen, und wie belege ich das regelmäßig?“
Teil 4, mit Lab und zwei AbfragenZum Artikel →Geplant sind weitere Teile zur Bestandsaufnahme über viele Instanzen, zu Logins und Rechten, zur Migration, zu Agent-Jobs und Wartungsskripten, zu Availability Groups, zu automatisierten Prüfungen und zu dbatools unter Linux.
Methode und Grenzen
- Zwei Labore: Das Hauptlabor läuft auf Linux mit SQL Server in Containern. So lassen sich vier Versionen nebeneinander und reproduzierbar prüfen. Ergänzend gibt es einen Windows-Server mit zwei Instanzen. Dort haben wir geprüft, was nur unter Windows geht oder dort anders sein könnte: Signatur, Ablage der Einstellungen, Instanzzählung, WMI-Prüfungen, Freigaben und
-CopyFile. Die Befunde zur Logik der Befehle selbst haben sich unter Windows bestätigt, etwa das verlorene Vertrauen bei Verbindungsobjekten. Wo ein Ergebnis nur für ein System gilt oder wir es nur ableiten, steht das dabei. - Software: dbatools 2.9.1 mit dbatools.library 2026.9.14, PowerShell 7.6.8 unter Linux im Image
mcr.microsoft.com/dotnet/sdk:10.0. Die Module haben wir als Pakete aus der PowerShell Gallery geladen und ihre Prüfsummen mit den Angaben der Gallery verglichen. - Server: SQL Server 2017 CU31, 2019 CU32, 2022 CU27 und 2025 CU9 in Linux-Containern auf einem Host mit 24 logischen CPUs und cgroup v2; Läufe am 13. und 16.11.2026.
- Quelltext: Für die zitierten Befehle haben wir die betreffenden Stellen im Quelltext von 2.9.1 gelesen, nicht das ganze Modul. Ob es zu unseren Befunden schon Meldungen gibt, haben wir am 16.11.2026 in den Issues und Pull Requests auf GitHub gesucht.
- Windows: Windows Server 2022 als VM mit zwei Instanzen SQL Server 2022 RTM und Integration Services, dbatools 2.9.1 unter Windows PowerShell 5.1 mit Windows-Anmeldung; Lauf am 17.11.2026.
- Nicht geprüft: Windows-Client gegen entfernte Windows-Server, Domänen und PowerShell 7 unter Windows. Was wir nur aus Dokumentation und Quelltext beschreiben, ist gekennzeichnet.
Weiterlesen
- dbatools: dbatools.io, Befehlsbrowser, Quelltext auf GitHub, PowerShell Gallery.
- Buch: Learn dbatools in a Month of Lunches (Manning, Mai 2022).
- Projektangaben: README 2.9.1 (Voraussetzungen, „250+ contributors“, Slack), Versionen auf GitHub.
- Bei PSG: Backup & Restore, SQL Server unter Linux und Docker, TempDB, SQL Server Performance.