Open Source · dbatools

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.

Geprüft mit dbatools 2.9.1 am 17.11.2026 · ca. 7 Minuten

Reihe dbatoolsGeprüft mit dbatools 2.9.1Lab SQL Server 2017–2025
PS>Test-DbaMaxDop -SqlInstance $alle40 Instanzen36 wie empfohlen3 Abweichungen1 nur Warnung

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-DbaLastBackup stellt die letzte Sicherung wieder her und lässt DBCC CHECKDB laufen. 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:

VerbWas es tutBeispiele
Get-Dba…liest Zustand und KonfigurationGet-DbaDatabase, Get-DbaLastBackup, Get-DbaAgentJob
Test-Dba…vergleicht mit einer Regel oder probiert etwas ausTest-DbaMaxDop, Test-DbaTempDbConfig, Test-DbaLastBackup
Copy-Dba…überträgt Objekte zwischen InstanzenCopy-DbaLogin, Copy-DbaAgentJob, Copy-DbaDatabase
Set-Dba…ändert EinstellungenSet-DbaMaxDop, Set-DbaMaxMemory
Install-Dba…spielt Community-Skripte einInstall-DbaMaintenanceSolution, Install-DbaWhoIsActive
Start-, Invoke-größere Abläufe und freie AbfragenStart-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 $s

Auf 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 #dbatools in der SQL Community Slack.
567laufen überall: Windows, Linux, macOS160nur unter WindowsEin Punkt ist ein Befehl. Befehlsbrowser auf dbatools.io, gezählt am 17.11.2026, dbatools 2.9.1.
567laufen überall: Windows, Linux, macOS160nur unter WindowsEin Punkt ist ein Befehl. Befehlsbrowser aufdbatools.io, gezählt am 17.11.2026, dbatools2.9.1.
Wie viele Befehle unter Linux und macOS laufen: Der Befehlsbrowser kennzeichnet jeden Befehl als „Runs anywhere“ oder „Windows only“. Die Windows-Befehle brauchen etwa WMI, Remoting oder Windows-Dienste.

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

  1. 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).
  2. Verschlüsselung nicht pauschal abschalten. Set-DbatoolsInsecureConnection beseitigt die Zertifikatsfehler, schaltet aber auch die Verschlüsselung ab und gilt dauerhaft. Für Labore reicht -TrustServerCertificate je Verbindung; für Produktion gehört ein richtiges Zertifikat auf den Server (Teil 1).
  3. Schreibende Befehle erst mit -WhatIf, dann auf einem Testziel. Befehle, die etwas ändern, kennen -WhatIf und -Confirm. Auch lesende Befehle können Last erzeugen: Test-DbaLastBackup stellt ohne -Destination auf der Quellinstanz wieder her (Teil 4).
  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

Die Reihe

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