Open Source · dbatools

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.

Geprüft mit dbatools 2.9.1 am 18.11.2026 · ca. 14 Minuten

Teil 2 · BestandSQL-Abfrage 1Lab Windows · Linux
Dieselben Server, zwei ReferenzenTest-DbaBuild -MaxBehind 0CUReferenz 13.10.nach Update · 12.11.Update-DbaBuildReferencesql2017CU31TrueTruesql2019CU32TrueTruesql2022CU27TrueFalseZiel CU28sql2025CU9TrueFalseZiel CU11sql2025cu10CU10TrueFalseZiel CU11„0 CUs zurück“ heißt: auf dem Stand der Referenz

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-DbaInstance ist ein Netzscanner, kein Inventar. Setzen Sie ihn nur im eigenen Netz und mit Freigabe ein.
  • Patchstand mit Test-DbaBuild bewerten, nicht mit Get-DbaBuild allein. Get-DbaBuild meldete für SQL Server 2022 RTM keine Warnung, obwohl 28 CUs fehlten. Erst Test-DbaBuild -MaxBehind zeigte 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-DbaBuild nicht. SQL Server 2025 CU10 erschien mit der alten Referenz als CU9, ohne Warnung.
  • Export-DbaInstance mit -ExcludePassword aufrufen. 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-DbaDatabase lieferte Wiederherstellungsmodell, Besitzer, Kompatibilität, Größe und letzte Sicherungen. Fehlende Sicherungen stehen dort als 01/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-DbaRegServer liest 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\Instanz

Die Datei des Linux-Labs enthielt fünf Namen:

Ausgabe im Lab
sql2017
sql2019
sql2022
sql2025
sql2025cu10

Auf 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, Warning
Ausgabe im Lab
SqlInstance    : 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, MaxBehind

Ergebnis mit aktualisierter Build-Referenz (Abschnitt 3):

Ausgabe im Lab
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     0CU

Auch 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:

  • -MaxBehind zählt nur CUs (und Service Packs). Zurückgezogene CUs zählen nicht mit (Quelltext 2.9.1, Test-DbaBuild Zeile 339).
  • -Latest vergleicht mit dem jüngsten Eintrag der Hauptversion, Sicherheitsupdates eingeschlossen (Zeilen 325–326). Im Linux-Lab war -Latest deshalb auf allen Instanzen False, auch dort, wo -MaxBehind 0CU True meldete: SQL Server 2017 CU31 und 2019 CU32 hatten das Sicherheitsupdate vom September, die Referenz kannte bereits ein jüngeres.
  • -MaxTimeBehind 3Mo braucht ein Veröffentlichungsdatum aus der Referenz. Fehlt es, ist das Ergebnis False mit der Warnung No ReleaseDate found for build 17.0.5035 - cannot determine time-based compliance.
  • -MinimumBuild gilt über alle Hauptversionen hinweg. Gegen 16.0.4295 waren 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);
Ausgabe im Lab
server    build       product_level remote_dac
------    -----       ------------- ----------
SQLSRV-01 16.0.1000.6 RTM                    0

dbatools 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, Compliant
Ausgabe im Lab
SqlInstance    Build     BuildTarget Compliant
-----------    -----     ----------- ---------
SQLSRV-01      16.0.1000                 False
SQLSRV-01\SQL2 16.0.1000                 False

16.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.

ReferenzStand (LastUpdated)Einträgejüngster 2022-Buildjüngster 2025-Build
mit dbatools 2.9.1 ausgeliefert13.10.20261.17216.0.430517.0.5015
nach Update-DbaBuildReference am 18.11.202612.11.20261.18416.0.432517.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:

InstanzBuildmit ausgelieferter Referenznach Update-DbaBuildReference
sql201714.0.3550 (CU31)TrueTrue
sql201915.0.4490 (CU32)TrueTrue
sql202216.0.4295 (CU27)TrueFalse, Ziel CU28
sql202517.0.5005 (CU9)TrueFalse, Ziel CU11
sql2025cu1017.0.5035 (CU10)TrueFalse, 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).LastUpdated

Unter 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.DbatoolsData
Ausgabe im Lab
C:\Users\Administrator\AppData\Roaming\PowerShell\dbatools

Unter 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:

Ausgabe im Lab
[Get-DbaBuildReferenceIndexOnline] Couldn't download updated index from https://127.0.0.1:9/dbatools-buildref-index.json

Auch 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:

Ausgabe im 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:

Ausgabe im Lab
"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_einfach gehört einem SQL-Login, nicht sa.
  • Kompatibilität: Dieselbe Datenbank läuft auf Kompatibilitätsgrad 130, also dem von SQL Server 2016, obwohl die Instanz 2022 ist.
  • Sicherungen: inventar_ohne_sicherung steht im Wiederherstellungsmodell Full, 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 = 10

Eine 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:

Ausgabe im Lab
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      0

Credentials 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.sql enthielt das Secret des Test-Credentials im Klartext.
  • linkedservers.sql enthielt das Passwort des Verbindungsservers nicht, nur ########.
  • extendedevents.sql fehlte, databases.sql hatte 0 Byte.

Dazu kamen zwei Warnungen:

Ausgabe im Lab
[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 host

Wir 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:

Ausgabe im Lab
[Export-DbaInstance] Failure | An existing connection was forcibly closed by the remote host

Es 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 connections aus war. Die Instanz entfiel ganz, auf allen fünf Versionen, mit der Warnung [Export-DbaInstance] Failure | Success.
  • Mit -ExcludePassword entstanden 10 Dateien. Credentials und Verbindungsserver fehlten trotzdem: [Export-DbaCredential] This command is not supported on Linux or macOS, ebenso für Export-DbaLinkedServer. Richtlinien überspringt der Befehl unter Linux (Quelltext Zeilen 454–457), die Replikation meldete Could not load replication libraries. ….
  • Mit erlaubter Remote-DAC wurde es nicht besser. Auf SQL Server 2022 mit remote admin connections = 1 dauerte der Export 99 Sekunden; databases.sql war leer, extendedevents.sql fehlte, wie beim Windows-Standardaufruf.
  • Randnotiz: regserver.xml landete 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, ScanTypes
Ausgabe im Lab
ComputerName InstanceName  Port Availability Confidence ScanTypes
------------ ------------  ---- ------------ ---------- ---------
SQLSRV-01    SQL2         49897    Available       High   Default
SQLSRV-01    MSSQLSERVER   1433    Available       High   Default

Beide Instanzen kamen mit Confidence High, auch die benannte Instanz mit ihrem dynamischen Port. Die Sicherheit stammt aus zwei Quellen:

  • -ScanType Browser allein ergab Medium, Availability Unknown.
  • -ScanType SQLService allein (WMI-Dienstabfrage) ergab High, aber Port 0.
  • -ScanType All meldete 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-DbaRegServer oder eine Datei unter Versionskontrolle. Find-DbaInstance nur zur Suche nach Lücken, mit Freigabe.
  • Referenz zuerst: Update-DbaBuildReference im selben Lauf und unter demselben Konto, dann LastUpdated der Kopie in den Bericht schreiben.
  • Bewerten mit Test-DbaBuild: -MaxBehind für den CU-Stand, -Latest für Sicherheitsupdates, -MinimumBuild dreiteilig und je Hauptversion. MatchType Approximate und Warnungen mit ausgeben.
  • Datenbanken als CSV: Get-DbaDatabase über die ganze Liste; fehlende Sicherungen stehen als 01/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-DbaBuildReference lief 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-DbaInstance mit und ohne -ExcludePassword, mit belegter DAC, die Einzelexporte der Passwörter und Find-DbaInstance gegen den eigenen Rechner. Die VM hatte eine vCPU; Laufzeiten von dort verwenden wir nicht.
  • Nur aus dem Quelltext: Update-DbaBuildReference -LocalFile, die SPN-Suche von Find-DbaInstance im 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-DbaDatabase unter Windows, ein Build jünger als die Referenz und der Offline-Fall unter Windows, Richtlinien mit eigenem Inhalt, DataSourceEnumeration unter Windows, große Umgebungen mit vielen Instanzen.

Weiterlesen

Weitere Teile der Reihe