SQL-Server-Bestand mit dbatools erfassen
Welche Instanzen haben wir, in welcher Version und auf welchem Patchstand? Welche Datenbanken liegen darauf, wem gehören sie, und wie sind die Server konfiguriert? Diese Fragen stellen sich vor jedem Audit, jeder Migration und jedem Patchtag. Mit SSMS beantwortet man sie Instanz für Instanz.
dbatools beantwortet sie für eine ganze Liste von Instanzen auf einmal. Get-DbaBuild und Test-DbaBuild bewerten den Patchstand, Get-DbaDatabase listet die Datenbanken, Export-DbaInstance schreibt die Konfiguration als Skripte weg. Diese Seite zeigt, welche Aufrufe im Lab funktioniert haben, warum die Bewertung des Patchstands so aktuell ist wie eine Referenzdatei und wo der Export weniger enthält, als man erwartet. Geprüft mit dbatools 2.9.1 am 18.11.2026; wie, steht am Ende unter „Was wir gemessen haben und was nicht“.
In 60 Sekunden
- Zuerst die Liste. Eine gepflegte Instanzliste, im Central Management Server oder als Datei, ist die Grundlage.
Find-DbaInstanceist ein Netzscanner, kein Inventar. Setzen Sie ihn nur im eigenen Netz und mit Freigabe ein. - Patchstand mit
Test-DbaBuildbewerten, nicht mitGet-DbaBuildallein.Get-DbaBuildmeldete für SQL Server 2022 RTM keine Warnung, obwohl 28 CUs fehlten. ErstTest-DbaBuild -MaxBehindzeigte den Rückstand. - Die Bewertung ist so aktuell wie die Build-Referenz. Version 2.9.1 bringt eine Referenz vom 13.10.2026 mit. Damit galt 2022 CU27 als aktuell. Nach
Update-DbaBuildReference(Stand 12.11.2026) lag es einen CU zurück. Geben Sie den Stand der Referenz im Bericht mit aus. - Neuere Builds als die Referenz erkennt
Get-DbaBuildnicht. SQL Server 2025 CU10 erschien mit der alten Referenz als CU9, ohne Warnung. Export-DbaInstancemit-ExcludePasswordaufrufen. Der Standardaufruf braucht die Dedicated Admin Connection (DAC). Selbst lokal unter Windows lieferte er einen lückenhaften Export mit einem Secret im Klartext. War die DAC belegt, entstand keine einzige Datei. Prüfen Sie deshalb auf Dateien, nicht auf Fehlermeldungen.- Datenbanken über alle Instanzen in eine CSV. Ein Aufruf von
Get-DbaDatabaselieferte Wiederherstellungsmodell, Besitzer, Kompatibilität, Größe und letzte Sicherungen. Fehlende Sicherungen stehen dort als01/01/0001 00:00:00, nicht als leeres Feld.
1 · Die Instanzliste
Fast jeder dbatools-Befehl nimmt mit -SqlInstance eine Liste von Instanzen. Die Bestandsaufnahme ist also nur so vollständig wie diese Liste. Zwei Wege sind üblich:
- Central Management Server oder Registered Servers. Viele Teams pflegen ihre Server bereits in einem Central Management Server (CMS).
Get-DbaRegServerliest diese Einträge, sodass dieselbe Liste in SSMS und in Skripten gilt. Einen CMS haben wir im Lab nicht aufgebaut; den Befehl beschreiben wir hier nur. - Eine Textdatei. Ein Instanzname je Zeile, benannte Instanzen als
Rechner\Instanz. So haben wir im Lab gearbeitet.
$instanzen = Get-Content .\instanzen.txt # ein Instanzname je Zeile, benannte Instanzen als Rechner\InstanzDie Datei des Linux-Labs enthielt fünf Namen:
sql2017
sql2019
sql2022
sql2025
sql2025cu10Auf dem Windows-Server mit zwei Instanzen haben wir die Namen direkt übergeben: SQLSRV-01, SQLSRV-01\SQL2.
Find-DbaInstance sucht Instanzen im Netz. Das hilft, Lücken in der Liste zu finden, ersetzt sie aber nicht (Abschnitt 6).
2 · Versions- und Patchstand
Was Get-DbaBuild meldet
Get-DbaBuild liest die Buildnummer jeder Instanz und schlägt sie in einer Referenzdatei nach. Zurück kommen Hauptversion, Service Pack, CU, KB-Artikel und das Supportende. Gegen den Windows-Server mit Windows-Anmeldung:
# Laborabkürzung für selbstsignierte Zertifikate, nur diese Sitzung (Teil 1)
Set-DbatoolsConfig -FullName sql.connection.trustcert -Value $true
Get-DbaBuild -SqlInstance SQLSRV-01, SQLSRV-01\SQL2 |
Format-List SqlInstance, Build, NameLevel, SPLevel, CULevel, KBLevel, BuildLevel, SupportedUntil, MatchType, WarningSqlInstance : SQLSRV-01
Build : 16.0.1000
NameLevel : 2022
SPLevel : RTM
CULevel :
KBLevel :
BuildLevel : 16.0.1000
SupportedUntil : 11.01.2033 00:00:00
MatchType : Exact
Warning :
…Beide Instanzen liefen mit SQL Server 2022 RTM, ohne ein einziges CU. Warning ist trotzdem leer, MatchType ist Exact. SupportedUntil gilt für die Hauptversion, nicht für den Patchstand: 2022 CU27 bekam im Linux-Lab dasselbe Datum. Get-DbaBuild beschreibt also, was installiert ist. Ob das genügt, sagt es nicht.
Test-DbaBuild zeigt den Rückstand
Test-DbaBuild vergleicht denselben Build mit einer Vorgabe und setzt Compliant:
Test-DbaBuild -SqlInstance SQLSRV-01, SQLSRV-01\SQL2 -MaxBehind 0CU |
Format-Table SqlInstance, Build, BuildTarget, Compliant, CUTarget, MaxBehindErgebnis mit aktualisierter Build-Referenz (Abschnitt 3):
SqlInstance Build BuildTarget Compliant CUTarget MaxBehind
----------- ----- ----------- --------- -------- ---------
SQLSRV-01 16.0.1000 16.0.4325 False CU28 0CU
SQLSRV-01\SQL2 16.0.1000 16.0.4325 False CU28 0CUAuch mit -MaxBehind 30CU blieb RTM False, mit Ziel CU1. Für einen Bericht über viele Instanzen gehört deshalb Test-DbaBuild dazu, nicht nur Get-DbaBuild.
Die Vorgaben messen Unterschiedliches:
-MaxBehindzählt nur CUs (und Service Packs). Zurückgezogene CUs zählen nicht mit (Quelltext 2.9.1,Test-DbaBuildZeile 339).-Latestvergleicht mit dem jüngsten Eintrag der Hauptversion, Sicherheitsupdates eingeschlossen (Zeilen 325–326). Im Linux-Lab war-Latestdeshalb auf allen InstanzenFalse, auch dort, wo-MaxBehind 0CUTruemeldete: SQL Server 2017 CU31 und 2019 CU32 hatten das Sicherheitsupdate vom September, die Referenz kannte bereits ein jüngeres.-MaxTimeBehind 3Mobraucht ein Veröffentlichungsdatum aus der Referenz. Fehlt es, ist das ErgebnisFalsemit der WarnungNo ReleaseDate found for build 17.0.5035 - cannot determine time-based compliance.-MinimumBuildgilt über alle Hauptversionen hinweg. Gegen16.0.4295waren 2017 und 2019 im Linux-Lab nicht konform. Bei gemischten Versionen braucht jede Hauptversion ihren eigenen Aufruf.
-MinimumBuild dreiteilig schreiben
SQL Server selbst meldet eine vierteilige Versionsnummer:
-- Build, Stufe und Remote-DAC-Einstellung dieser Instanz (nur lesend)-- MAXDOP 1: läuft seriell und belegt keine weiteren Kerne der AnwendungSELECT @@SERVERNAME AS server, CAST(SERVERPROPERTY('ProductVersion') AS varchar(20)) AS build, CAST(SERVERPROPERTY('ProductLevel') AS varchar(10)) AS product_level, (SELECT value_in_use FROM sys.configurations WHERE name = 'remote admin connections') AS remote_dacOPTION (MAXDOP 1);server build product_level remote_dac
------ ----- ------------- ----------
SQLSRV-01 16.0.1000.6 RTM 0dbatools rechnet mit drei Teilen (16.0.1000). Wer die Nummer aus SQL Server übernimmt, bekommt für genau diesen Build ein falsches Ergebnis:
Test-DbaBuild -SqlInstance SQLSRV-01, SQLSRV-01\SQL2 -MinimumBuild 16.0.1000.6 |
Format-Table SqlInstance, Build, BuildTarget, CompliantSqlInstance Build BuildTarget Compliant
----------- ----- ----------- ---------
SQLSRV-01 16.0.1000 False
SQLSRV-01\SQL2 16.0.1000 False16.0.1000 ist kleiner als 16.0.1000.6. Schreiben Sie Vorgaben deshalb dreiteilig, so wie Get-DbaBuild den Build meldet. Das gilt unabhängig vom Betriebssystem.
3 · Die Build-Referenz bestimmt das Ergebnis
Get-DbaBuild und Test-DbaBuild fragen nicht bei Microsoft nach. Sie schlagen in einer JSON-Datei nach, die das dbatools-Projekt pflegt und mit jeder Version mitliefert. Beim ersten Aufruf legt dbatools eine beschreibbare Kopie im Benutzerprofil an; es gilt die jüngere der beiden (Quelltext 2.9.1, Get-DbaBuild Zeilen 243–251). Update-DbaBuildReference lädt die aktuelle Fassung aus dem Netz.
| Referenz | Stand (LastUpdated) | Einträge | jüngster 2022-Build | jüngster 2025-Build |
|---|---|---|---|---|
| mit dbatools 2.9.1 ausgeliefert | 13.10.2026 | 1.172 | 16.0.4305 | 17.0.5015 |
nach Update-DbaBuildReference am 18.11.2026 | 12.11.2026 | 1.184 | 16.0.4325 | 17.0.5065 |
Unter Windows und Linux lud der Befehl dieselbe Fassung. Die Referenz pflegt das Projekt für alle Nutzer mit; die Fassung vom 12.11. war einen Tag nach der Zusammenführung ihres Pull Requests online (#10826).
Dieselben Server, zwei Ergebnisse
Im Linux-Lab liefen fünf Instanzen mit den damals aktuellen Ständen. Test-DbaBuild -MaxBehind 0CU bewertete sie je nach Referenz verschieden:
| Instanz | Build | mit ausgelieferter Referenz | nach Update-DbaBuildReference |
|---|---|---|---|
| sql2017 | 14.0.3550 (CU31) | True | True |
| sql2019 | 15.0.4490 (CU32) | True | True |
| sql2022 | 16.0.4295 (CU27) | True | False, Ziel CU28 |
| sql2025 | 17.0.5005 (CU9) | True | False, Ziel CU11 |
| sql2025cu10 | 17.0.5035 (CU10) | True | False, Ziel CU11 |
Unter Windows war es dasselbe Muster: Für 2022 RTM nannte -MaxBehind 0CU mit der ausgelieferten Referenz CU27 als Ziel, nach der Aktualisierung CU28.
Ein „0 CUs zurück“ heißt also: auf dem Stand der Referenz. Geben Sie deren Datum im Bericht mit aus, und aktualisieren Sie sie vor jedem Lauf:
Update-DbaBuildReference
$ref = Join-Path (Get-DbatoolsConfigValue -FullName Path.DbatoolsData) 'dbatools-buildref-index.json'
(Get-Content $ref -Raw | ConvertFrom-Json).LastUpdatedUnter Windows PowerShell 5.1 ergab die letzte Zeile 2026-11-12T00:00:00.
Eine Kopie je Benutzerprofil
Die Kopie liegt im Profil des Benutzers, der dbatools ausführt:
Get-DbatoolsConfigValue -FullName Path.DbatoolsDataC:\Users\Administrator\AppData\Roaming\PowerShell\dbatoolsUnter Linux lag sie unter ~/.local/share/PowerShell/dbatools/. Läuft die Bestandsaufnahme als geplante Aufgabe oder Agent-Job unter einem Dienstkonto, hat dieses Konto seine eigene Kopie. Sie wird nur aktuell, wenn der Job selbst Update-DbaBuildReference aufruft.
dbatools warnt erst, wenn die Referenz älter als 45 Tage ist (Quelltext 2.9.1, Get-DbaBuild Zeile 264). Für die ausgelieferte Referenz vom 13.10.2026 kommt diese Warnung ab dem 27.11.2026. Bis dahin bewertet ein nicht aktualisierter Lauf still gegen den Oktober-Stand.
Ohne Internet bleibt es bei einer Warnung
Im Lab haben wir die Quelle der Referenz in einer Sitzung auf eine unerreichbare Adresse umgebogen. Update-DbaBuildReference meldete nur:
[Get-DbaBuildReferenceIndexOnline] Couldn't download updated index from https://127.0.0.1:9/dbatools-buildref-index.jsonAuch mit -EnableException brach der Befehl nicht ab. Get-DbaBuild -Update und Test-DbaBuild -Update rechneten danach mit der alten Kopie weiter. Wer nachts prüft, sollte deshalb LastUpdated der Kopie selbst überwachen. Für Netze ohne Internet nennt der Quelltext Update-DbaBuildReference -LocalFile; das haben wir nicht ausprobiert.
Builds, die jünger sind als die Referenz
SQL Server 2025 CU10 (17.0.5035) erschien nach dem 13.10.2026 und fehlt deshalb in der ausgelieferten Referenz. Get-DbaBuild meldete dafür im Linux-Lab:
SqlInstance : sql2025cu10
Build : 17.0.5035
CULevel : CU9
KBLevel : 5126967
ReleaseDate : 10/13/2026 00:00:00
MatchType : Approximate
Warning :Die Instanz erscheint als CU9, mit KB-Nummer und Datum des Sicherheitsupdates vom Oktober. Der Hinweis steckt nur in MatchType Approximate, Warning bleibt leer. Die Ursache liegt in der Suchschleife: Die Warnung „… not found, closest build we have is …“ entsteht nur, wenn in der Referenz noch ein größerer Eintrag folgt (Quelltext 2.9.1, Zeilen 342–346). Für einen Build innerhalb der Referenz kommt sie: Get-DbaBuild -Build 16.0.1000.6 meldete unter Windows 16.0.1000.6 not found, closest build we have is 16.0.1000.
Test-DbaBuild warnt in diesem Fall immerhin mit 17.0.5035 is not recognized as a correct version. Mit der alten Referenz galt CU10 trotzdem als -Latest-konform, und offline bewertete Test-DbaBuild -MaxBehind 1CU -Update es als CU9 gegen das Ziel CU8. Nach der Aktualisierung erkannte Get-DbaBuild CU10 richtig (Exact). Den Fall haben wir nur im Linux-Lab nachgestellt. Unter Windows verhielt sich die Suchschleife gleich: Warnung nur bei einem größeren Folgeeintrag. Stand 18.11.2026 war der Befund im Projekt nicht gemeldet.
4 · Datenbanken über alle Instanzen
Get-DbaDatabase liefert je Datenbank ein Objekt. Über die Instanzliste aus Abschnitt 1 entsteht daraus mit Export-Csv eine Tabelle für alle Server. Im Linux-Lab, mit SQL-Anmeldung:
$cred = Get-Credential sa
Get-DbaDatabase -SqlInstance $instanzen -SqlCredential $cred |
Select-Object SqlInstance, Name, Status, RecoveryModel, Owner, Compatibility, SizeMB, LastFullBackup, LastLogBackup, IsSystemObject |
Export-Csv -Path .\datenbanken.csv -NoTypeInformationÜber fünf Instanzen kamen 35 Zeilen zurück, darunter je Instanz drei Testdatenbanken. Auszug für SQL Server 2022:
"SqlInstance","Name","Status","RecoveryModel","Owner","Compatibility","SizeMB","LastFullBackup","LastLogBackup","IsSystemObject"
…
"sql2022","inventar_voll","Normal","Full","sa","Version160","16","11/18/2026 05:58:03","11/18/2026 05:58:03","False"
"sql2022","inventar_einfach","Normal","Simple","dbt_besitzer","Version130","16","11/18/2026 05:58:04","01/01/0001 00:00:00","False"
"sql2022","inventar_ohne_sicherung","Normal","Full","sa","Version160","16","01/01/0001 00:00:00","01/01/0001 00:00:00","False"
…Was die Liste auf einen Blick zeigt:
- Besitzer:
inventar_einfachgehört einem SQL-Login, nichtsa. - Kompatibilität: Dieselbe Datenbank läuft auf Kompatibilitätsgrad 130, also dem von SQL Server 2016, obwohl die Instanz 2022 ist.
- Sicherungen:
inventar_ohne_sicherungsteht im WiederherstellungsmodellFull, hat aber nie eine Vollsicherung bekommen.
Fehlende Sicherungen erscheinen als 01/01/0001 00:00:00, nicht als leeres Feld. Ein Filter auf leere Werte findet sie nicht. Prüfen Sie einen solchen Filter an einer Datenbank ohne Sicherung, bevor Sie dem Bericht trauen. Wie man Sicherungen nicht nur zählt, sondern wiederherstellt, zeigt Teil 4.
Ohne Select-Object zeigt Get-DbaDatabase außerdem IsAccessible, LogReuseWaitStatus, Collation, Encrypted und LastDiffBackup. Für Excel statt CSV gibt es das Gemeinschaftsmodul ImportExcel; das haben wir nicht geprüft. Get-DbaDatabase haben wir in dieser Messung nur im Linux-Lab ausgeführt.
5 · Konfiguration dokumentieren mit Export-DbaInstance
Export-DbaInstance schreibt die Konfiguration einer Instanz als Skripte in einen Ordner, je Instanz und Lauf ein neuer Ordner mit Zeitstempel im Namen. Dazu gehören sp_configure, Logins, Serverrollen, Credentials, Verbindungsserver, Database Mail, Agent-Jobs, Extended-Events-Sitzungen, Resource Governor, Richtlinien und registrierte Server.
Eine Datei heißt anders, als sie ist: databases.sql enthält kein Schema, sondern RESTORE-Befehle aus der Sicherungshistorie (laut Hilfe). Im Linux-Lab (gekürzt):
RESTORE DATABASE [inventar_voll] FROM DISK = N'/var/opt/mssql/data/inventar_voll.bak' WITH FILE = 1, MOVE N'inventar_voll' TO N'/var/opt/mssql/data/inventar_voll.mdf', … NORECOVERY, NOUNLOAD, REPLACE, STATS = 10RESTORE LOG [inventar_voll] FROM DISK = N'/var/opt/mssql/data/inventar_voll.trn' WITH FILE = 1, … NOUNLOAD, STATS = 10Eine Datenbank ohne Sicherung fehlt darin, und die Pfade sind die der Quelle.
Empfohlen: -ExcludePassword
Lokal auf dem Windows-Server:
$dateien = @(Export-DbaInstance -SqlInstance SQLSRV-01 -Path C:\lab\w2\export -ExcludePassword)
if ($dateien.Count -eq 0) { 'Kein Export für SQLSRV-01' }Der Aufruf gab 15 Dateien zurück und legte sie im Ordner SQLSRV-01-20261118085342 ab:
Name Length
---- ------
credentials.sql 169
databases.sql 688
dbmail.sql 1365
extendedevents.sql 13784
linkedservers.sql 1653
logins.sql 869
OleDbProvider.sql 4722
policymanagement.sql 2
regserver.xml 3121
replication.sql 586
resourcegov.sql 421
serverroles.sql 1099
sp_configure.sql 4882
sqlagent.sql 9287
userobjectsinsysdbs.sql 0Credentials und Verbindungsserver sind enthalten, ihre Passwörter durch Platzhalter ersetzt:
IF NOT EXISTS (SELECT 1 FROM sys.credentials WHERE name = N'dbt_cred') CREATE CREDENTIAL [dbt_cred] WITH IDENTITY = N'dbt_ident', SECRET = N'<EnterStrongPasswordHere>' /* For security reasons the linked server remote logins password is changed with ######## */EXEC master.dbo.sp_addlinkedsrvlogin @rmtsrvname=N'DBT_LINK',@useself=N'False',@locallogin=NULL,@rmtuser=N'dbt_remote',@rmtpassword='########'Das ist für eine Dokumentation, die in einem Repository oder auf einem Dateiserver liegt, die richtige Form. policymanagement.sql war mit 2 Byte leer: Auf dem Server gab es 16 Richtlinien und 17 Bedingungen von Microsoft, aber keine eigenen. Wie der Export eigene Richtlinien schreibt, haben wir nicht geprüft.
Der Standardaufruf braucht die DAC
Ohne -ExcludePassword will Export-DbaInstance die Passwörter von Credentials und Verbindungsservern entschlüsseln. Dafür öffnet es zuerst eine Dedicated Admin Connection und benutzt sie für den ganzen Export (Quelltext 2.9.1, Zeilen 286–304). Lokal unter Windows gelang die Verbindung, beide Instanzen lieferten 14 Dateien. Der Export war trotzdem lückenhaft:
credentials.sqlenthielt das Secret des Test-Credentials im Klartext.linkedservers.sqlenthielt das Passwort des Verbindungsservers nicht, nur########.extendedevents.sqlfehlte,databases.sqlhatte 0 Byte.
Dazu kamen zwei Warnungen:
[Get-DecryptedObject] Can't unprotect registry data on SQLSRV-01. Do you have administrative access to the Windows registry on SQLSRV-01? Otherwise, we're out of ideas.
[Get-DbaXESession] Failure | An existing connection was forcibly closed by the remote hostWir haben als lokaler Administrator gearbeitet. Einzeln aufgerufen entschlüsselte Export-DbaLinkedServer dasselbe Passwort auf derselben Instanz. Warum es im Gesamtexport scheiterte, ist offen. Unsere Vermutung: Die gemeinsam benutzte DAC trägt nicht alle Teilschritte.
Ist die DAC belegt, entsteht nichts
SQL Server erlaubt je Instanz nur eine DAC. Hielt eine andere Sitzung sie offen, brach der Standardaufruf sofort ab:
[Export-DbaInstance] Failure | An existing connection was forcibly closed by the remote hostEs gab 0 Rückgabeobjekte und keinen Ordner. Im Fehlerprotokoll von SQL Server stand maximum number of '1' dedicated administrator connections already exists. Der Befehl wirft dabei keinen Fehler, er überspringt die Instanz und schreibt eine Warnung (Quelltext, Stop-Function … -Continue). Ein Skript, das nur auf Fehler achtet, meldet Erfolg. Prüfen Sie deshalb, ob Dateien zurückkommen, wie im Aufruf oben.
Passwörter nur gezielt
Wer Passwörter für einen Umzug wirklich braucht, exportiert sie gezielt mit Export-DbaCredential und Export-DbaLinkedServer. Beide öffnen ebenfalls die DAC. Im Lab entschlüsselten sie auf der Standardinstanz Secret und Verbindungsserver-Passwort. Auf der zweiten Instanz brach Export-DbaLinkedServer einmal mit Failure | An existing connection was forcibly closed by the remote host ab, ohne Datei; Export-DbaCredential direkt danach gelang. Behandeln Sie solche Dateien wie ein Geheimnis: nicht ins Repository, nicht auf Freigaben, nach Gebrauch löschen.
Auf entfernten Windows-Servern braucht die Entschlüsselung laut Hilfe und Quelltext zusätzlich remote admin connections und Windows-Zugriff auf den Server (#10549, offen). Diesen Fall haben wir nicht aufgebaut.
Vom Linux-Client aus
Läuft dbatools unter Linux oder macOS, etwa in einer Pipeline, gilt mehr Einschränkung:
- Der Standardaufruf exportiert nichts. Die DAC über das Netz scheiterte nach rund 14,5 Sekunden, weil
remote admin connectionsaus war. Die Instanz entfiel ganz, auf allen fünf Versionen, mit der Warnung[Export-DbaInstance] Failure | Success. - Mit
-ExcludePasswordentstanden 10 Dateien. Credentials und Verbindungsserver fehlten trotzdem:[Export-DbaCredential] This command is not supported on Linux or macOS, ebenso fürExport-DbaLinkedServer. Richtlinien überspringt der Befehl unter Linux (Quelltext Zeilen 454–457), die Replikation meldeteCould not load replication libraries. …. - Mit erlaubter Remote-DAC wurde es nicht besser. Auf SQL Server 2022 mit
remote admin connections = 1dauerte der Export 99 Sekunden;databases.sqlwar leer,extendedevents.sqlfehlte, wie beim Windows-Standardaufruf. - Randnotiz:
regserver.xmllandete unter Linux zusätzlich als Datei mit Backslash im Namen neben dem Exportordner (sql2017-20261118060021\regserver.xml). Unter Windows lag sie richtig im Ordner.
Die Linux-Befunde zum leeren Export und zu regserver.xml waren Stand 18.11.2026 im Projekt nicht gemeldet. Verwandt ist das offene #10549.
6 · Find-DbaInstance: suchen, nicht inventarisieren
Find-DbaInstance sucht SQL-Server-Instanzen im Netz. Je nach Aufruf fragt es Namen im Active Directory ab (SPN), durchläuft einen IP-Bereich, pingt, löst Namen auf, fragt den SQL-Server-Browser (UDP 1434) und über WMI die Windows-Dienste, prüft TCP-Ports und meldet sich auf Wunsch an. Das ist ein Netzscan. Setzen Sie ihn nur im eigenen Netz ein und nur mit Freigabe der Verantwortlichen für dieses Netz. Die Hilfe des Befehls rät selbst davon ab, ihn regelmäßig zu benutzen, und verweist auf Get-DbaService und Get-DbaRegServer.
Wir haben ihn nur gegen den eigenen Rechner und im eigenen Labornetz laufen lassen. Unter Windows, lokal als Administrator, ohne SQL-Anmeldung:
Find-DbaInstance -ComputerName SQLSRV-01 |
Select-Object ComputerName, InstanceName, Port, Availability, Confidence, ScanTypesComputerName InstanceName Port Availability Confidence ScanTypes
------------ ------------ ---- ------------ ---------- ---------
SQLSRV-01 SQL2 49897 Available High Default
SQLSRV-01 MSSQLSERVER 1433 Available High DefaultBeide Instanzen kamen mit Confidence High, auch die benannte Instanz mit ihrem dynamischen Port. Die Sicherheit stammt aus zwei Quellen:
-ScanType Browserallein ergabMedium,Availability Unknown.-ScanType SQLServiceallein (WMI-Dienstabfrage) ergabHigh, aber Port0.-ScanType Allmeldete sich zusätzlich an (SqlConnected True).
Vom Linux-Client aus gibt es weder Browser- noch WMI-Abfrage. Im Labornetz fanden die Standard-Scans die fünf Instanzen über DNS, Ping und Port 1433 nur mit Confidence Medium, ohne Warnung. High gab es erst mit -ScanType TCPPort, SqlConnect und Anmeldedaten. Die Suche über -DiscoveryType DataSourceEnumeration scheiterte unter PowerShell 7 mit Datasource enumeration failed | Unable to find type [System.Data.Sql.SqlDataSourceEnumerator].; unter Windows haben wir sie bewusst nicht ausgeführt, weil sie ins Netz rundsendet.
Für die Bestandsliste heißt das: Ein Treffer von Find-DbaInstance ist ein Kandidat für die Liste. Gepflegt wird die Liste im CMS oder in der Datei.
7 · Ein Bestandsbericht, der hält
- Liste aus einer Quelle: CMS über
Get-DbaRegServeroder eine Datei unter Versionskontrolle.Find-DbaInstancenur zur Suche nach Lücken, mit Freigabe. - Referenz zuerst:
Update-DbaBuildReferenceim selben Lauf und unter demselben Konto, dannLastUpdatedder Kopie in den Bericht schreiben. - Bewerten mit
Test-DbaBuild:-MaxBehindfür den CU-Stand,-Latestfür Sicherheitsupdates,-MinimumBuilddreiteilig und je Hauptversion.MatchType Approximateund Warnungen mit ausgeben. - Datenbanken als CSV:
Get-DbaDatabaseüber die ganze Liste; fehlende Sicherungen stehen als01/01/0001. - Konfiguration mit
Export-DbaInstance -ExcludePassword: Rückgabe auf Dateien prüfen. Passwörter nur gezielt und als Geheimnis behandelt. - Unerreichbare Instanzen melden: Viele Befehle schreiben bei einem Verbindungsfehler nur eine Warnung (Teil 1, Teil 3). Eine Instanz, die im Bericht fehlt, ist selbst ein Befund.
Was wir gemessen haben und was nicht
- Gemessen (18.11.2026): dbatools 2.9.1 unter PowerShell 7.6.8 in einem Linux-Container gegen fünf Instanzen in Linux-Containern: SQL Server 2017 CU31 und 2019 CU32 (jeweils mit Sicherheitsupdate vom September 2026), 2022 CU27, 2025 CU9 und 2025 CU10. Je Instanz drei kleine Testdatenbanken und ein Job, auf 2022 zusätzlich ein Credential und ein Verbindungsserver mit Passwort.
Update-DbaBuildReferencelief einmal online; den Offline-Fall haben wir durch eine umgebogene Quelladresse nachgestellt, nicht durch ein getrenntes Netz. - 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, lokal ausgeführt (Client und Server auf demselben Rechner), Windows-Anmeldung als Administrator. Geprüft wurden Build-Bewertung vor und nach der Aktualisierung,
Export-DbaInstancemit und ohne-ExcludePassword, mit belegter DAC, die Einzelexporte der Passwörter undFind-DbaInstancegegen den eigenen Rechner. Die VM hatte eine vCPU; Laufzeiten von dort verwenden wir nicht. - Nur aus dem Quelltext:
Update-DbaBuildReference -LocalFile, die SPN-Suche vonFind-DbaInstanceim Active Directory, die Entschlüsselung von Passwörtern auf entfernten Windows-Servern. - Nicht gemessen: ein Central Management Server mit
Get-DbaRegServer, Excel-Ausgabe, zwei getrennte Windows-Server und Domänen, PowerShell 7 unter Windows,Get-DbaDatabaseunter Windows, ein Build jünger als die Referenz und der Offline-Fall unter Windows, Richtlinien mit eigenem Inhalt,DataSourceEnumerationunter Windows, große Umgebungen mit vielen Instanzen.
Weiterlesen
- dbatools: Get-DbaBuild, Test-DbaBuild, Update-DbaBuildReference, Get-DbaDatabase, Export-DbaInstance, Find-DbaInstance, Get-DbaRegServer.
- Microsoft Learn: Diagnoseverbindung für Datenbankadministratoren (DAC), remote admin connections, Central Management Server.
- Bei PSG: dbatools-Übersicht, Teil 1: Installieren und sicher verbinden, Teil 3: Was
Test-Dbawirklich sagt, Teil 4: Backups wirklich prüfen, SQL Server unter Linux und Docker.