SQL-Agent-Jobs und Wartungsskripte mit dbatools verwalten
Auf jeder Instanz dieselben Sicherungs- und Prüfjobs, überall dieselbe Fassung der Wartungsskripte: So sieht der Sollzustand aus. Im Alltag weichen Instanzen davon ab. Ein Job wurde auf einem Server von Hand geändert, ein Skript liegt in einer älteren Fassung vor, und nach einem Umzug laufen Jobs plötzlich doppelt.
dbatools hat für diese Aufgabe zwei Gruppen von Befehlen. Mit Get-DbaAgentJob, Find-DbaAgentJob, Get-DbaAgentJobHistory und Copy-DbaAgentJob suchen, vergleichen und kopieren Sie Jobs über viele Instanzen. Mit Install-DbaMaintenanceSolution, Install-DbaFirstResponderKit und Install-DbaWhoIsActive spielen Sie drei verbreitete Community-Projekte ein. Diese Seite zeigt, welche Aufrufe im Lab funktioniert haben, was dabei tatsächlich installiert oder kopiert wurde und wo Sie nachprüfen sollten.
Gemessen haben wir vor allem auf einem Windows-Server mit zwei Instanzen. Wo SQL Server unter Linux abweicht, steht es beim jeweiligen Abschnitt. Ob und wie oft sich Indexwartung lohnt, beantwortet diese Seite nicht; dazu gibt es unsere Reihe Indexwartung verstehen.
Geprüft mit dbatools 2.9.1 am 18.11.2026.
In 60 Sekunden
- Community-Skripte kontrolliert installieren: Release von der Projektseite laden, Prüfsumme notieren, mit
-LocalFileinstallieren und danach die installierte Version abfragen. Die Erfolgsmeldung allein sagt nicht, welche Fassung auf dem Server liegt. -LocalFilebei Ola Hallengren: dbatools verwendet nur ein Archiv mit dem Ordnersql-server-maintenance-solution-main, wie esmain.zipenthält. Ein Tag-Archiv von Olas GitHub-Seite oder eine fehlende Datei verwirft der Befehl still, installiert seine mitgelieferte Kopie und meldetSuccess. Meldet Windows im Netzprofil kein Internet, ignoriert er-LocalFileganz (im Lab simuliert).- Ola unter Windows: 11 Agent-Jobs, davon „Output File Cleanup“ als CmdExec-Schritt, alle ohne Zeitplan. Alle gestarteten Jobs liefen erfolgreich. Unter Linux sind es 10 Jobs.
Copy-DbaAgentJob -DisableOnDestinationschaltet die kopierten Jobs ab, ihre Zeitpläne bleiben aktiv. Fehlt auf dem Ziel der Besitzer-Login oder der Proxy, wird der Job mitSkippedübersprungen.Find-DbaAgentJobkombiniert Filter nicht: Bei mehreren Bedingungen gilt nur eine (offen als #10853).-LastUsedfindet nie gelaufene Jobs, nicht fehlgeschlagene.- Ausgabedateien:
Get-DbaAgentJobHistory -WithOutputFilelässt den Jobnamen im Dateinamen als Platzhalter stehen. Unter Windows kommt der Pfad zusätzlich als UNC-Pfad über die AdministratorfreigabeC$.
1 · Community-Skripte: Herkunft, Lizenz, Version
dbatools baut die verbreiteten Wartungs- und Diagnoseskripte nicht nach, sondern bindet die Arbeit ihrer Urheber ein. Die drei Install--Befehle laden die Skripte aus den Projekten auf GitHub und nennen die Urheber in ihrer Hilfe:
- SQL Server Maintenance Solution von Ola Hallengren: Sicherung, Integritätsprüfung und Index- und Statistikpflege als gespeicherte Prozeduren und Agent-Jobs. Lizenz MIT, Dokumentation auf ola.hallengren.com. Ola veröffentlicht keine GitHub-Releases, nur Tags.
- First Responder Kit von Brent Ozar Unlimited:
sp_Blitz,sp_BlitzCache,sp_BlitzIndexund weitere Diagnoseprozeduren. Lizenz MIT, mit Urheberhinweisen für einzelne Teile. - sp_WhoIsActive von Adam Machanic: zeigt, was gerade auf der Instanz läuft und wer wen blockiert. Lizenz GPL-3.0.
Alle drei werden von ihren Urhebern und Beitragenden laufend gepflegt; Stand 17.11.2026 lag die letzte Änderung bei keinem länger als gut zwei Monate zurück. Bei einem Wartungsskript, das nachts auf jedem Server läuft, sollten Sie deshalb wissen, welche Fassung installiert ist und woher sie stammt.
Kontrolliert installieren
- Release von der Projektseite laden und als Datei ablegen, auch für Server ohne Internet.
- Prüfsumme notieren, zum Beispiel mit
Get-FileHash -Algorithm SHA256. - Mit
-LocalFileinstallieren, zuerst auf einer Testinstanz. - Installierte Version abfragen und mit Herkunft und Prüfsumme festhalten (Abschnitte 2 und 4).
Im Lab haben wir am 18.11.2026 diese fünf Archive geladen und vor jeder Installation geprüft:
Get-FileHash C:\lab\pakete\*.zip -Algorithm SHA256| Datei | Quelle | Stand | SHA-256 |
|---|---|---|---|
ola-main.zip | Maintenance Solution, archive/refs/heads/main.zip | Version 2026-09-12 15:02:38 | e0cd31305a946ad1f86c09a13d215956a2e3ba25fb9a94c5c75355886d5e22e0 |
ola-20260912_150238.zip | dto., Tag 20260912_150238 | gleiche Fassung wie main | 4a3598d595f7bacd6edd2e96c610bd3329677e1528efeadcada02fcaa899f20c |
ola-20260823_144645.zip | dto., Tag 20260823_144645 | Version 2026-08-23 14:46:45 | 48583527a9ed4326c6cef898a1db720460e49d547d1cb513a2252c2839666008 |
frk-20261114.zip | First Responder Kit, Release 20261114 | 8.35 | 122fea767442f5c87dc4fc0ce900ca57671e260df9e23d452eb3be981e792957 |
whoisactive-20260409.zip | sp_WhoIsActive, Release 20260409 | 20260409 | 2a486774b0efd18a7ba2a45b6bbff79d32c9a9ace6da679ed661aeb500efa125 |
Unter Linux und Windows waren die Prüfsummen identisch.
Wo dbatools die Skripte ablegt
Die Install--Befehle entpacken die Skripte in einen Zwischenspeicher im Datenordner von dbatools, Einstellung Path.DbatoolsData. Unter Windows lag er im Lab im Profil des Benutzers, C:\Users\Administrator\AppData\Roaming\PowerShell\dbatools. Drei Eigenschaften sollten Sie kennen:
- Ein vorhandener Zwischenspeicher wird ohne
-Forceoder-LocalFileweiterverwendet. Das ist bekanntes Verhalten (#10377). Wer einmal installiert hat, bekommt beim nächsten Aufruf dieselbe Fassung, auch wenn es online eine neuere gibt. - dbatools bringt eine eigene Kopie der Maintenance Solution mit (im Modul unter
bin/maintenancesolution, in 2.9.1 die Version 2026-09-12 15:02:38). Auf sie fälltInstall-DbaMaintenanceSolutionzurück, wenn etwas nicht klappt (Abschnitt 3). - Der Ordner muss existieren. Zeigte
Path.DbatoolsDataim Lab auf einen nicht vorhandenen Ordner, installierteInstall-DbaMaintenanceSolutionnichts und meldete weder Ergebnis noch Warnung.Install-DbaFirstResponderKitbrach mitCannot find path '/tmp/cache-frk/SQL-Server-First-Responder-Kit-main' because it does not exist.ab. Das betrifft nur einen selbst gesetzten Pfad; der Standardordner existiert normalerweise.
2 · Ola Hallengrens Wartungslösung installieren
Auf dem Windows-Server haben wir die Wartungslösung zuerst ohne -LocalFile installiert, mit Jobs und Protokolltabelle:
# Laborabkürzung für selbstsignierte Zertifikate, nur diese Sitzung, Verbindung bleibt verschlüsselt (Teil 1)
Set-DbatoolsConfig -FullName sql.connection.trustcert -Value $true
Install-DbaMaintenanceSolution -SqlInstance SQLSRV-01 -Database master -InstallJobs -LogToTable -CleanupTime 168 -VerboseVERBOSE: Performing the operation "Update local cached copy of the software" on target "MaintenanceSolution".
VERBOSE: GET https://github.com/olahallengren/sql-server-maintenance-solution/archive/main.zip with 0-byte payload
VERBOSE: received -1-byte response of content type application/zip
ComputerName InstanceName SqlInstance Results
------------ ------------ ----------- -------
SQLSRV-01 MSSQLSERVER SQLSRV-01 SuccessOhne -LocalFile lädt der Befehl also den aktuellen Stand des Zweigs main. Welche Fassung das ist, sagt Success nicht. Die Version steht im Kopf jeder Prozedur, zum Beispiel von dbo.DatabaseBackup:
$d = (Invoke-DbaQuery -SqlInstance SQLSRV-01 -Database master -As PSObject -Query "SELECT OBJECT_DEFINITION(OBJECT_ID(N'dbo.DatabaseBackup')) AS d;").d
[regex]::Match("$d", 'Version: [0-9-]+ [0-9:]+').ValueVersion: 2026-09-12 15:02:38Diese Abfrage haben wir nach jeder Installation ausgeführt. Sie ist die Grundlage für alle Versionsangaben in Abschnitt 3.
Welche Jobs entstehen
Einen Überblick über die Agent-Jobs einer Instanz, mit Besitzer, Zahl der Zeitpläne, Subsystemen und Ausgabedatei, liefert eine Abfrage auf msdb:
-- Agent-Jobs mit Besitzer, Zeitplänen, Subsystemen und Ausgabedatei (nur lesend, ab SQL Server 2017)-- MAXDOP 1: läuft seriell und belegt keine weiteren Kerne der AnwendungSELECT j.name AS job, j.enabled, SUSER_SNAME(j.owner_sid) AS owner, (SELECT COUNT(*) FROM msdb.dbo.sysjobschedules AS js WHERE js.job_id = j.job_id) AS schedules, (SELECT STRING_AGG(s.subsystem, ',') FROM msdb.dbo.sysjobsteps AS s WHERE s.job_id = j.job_id) AS subsystems, (SELECT MAX(s.output_file_name) FROM msdb.dbo.sysjobsteps AS s WHERE s.job_id = j.job_id) AS output_fileFROM msdb.dbo.sysjobs AS jORDER BY j.nameOPTION (MAXDOP 1);Ergebnis auf dem Windows-Server (Auszug, Ausgabedatei gekürzt):
job enabled owner schedules subsystems output_file
--- ------- ----- --------- ---------- -----------
CommandLog Cleanup 1 sa 0 TSQL $(ESCAPE_SQUOTE(SQLLOGDIR))\$(ESCAPE_SQUOTE(JOBNAME))_…
DatabaseBackup - SYSTEM_DATABASES - FULL 1 sa 0 TSQL $(ESCAPE_SQUOTE(SQLLOGDIR))\$(ESCAPE_SQUOTE(JOBNAME))_…
DatabaseBackup - USER_DATABASES - DIFF 1 sa 0 TSQL …
DatabaseBackup - USER_DATABASES - FULL 1 sa 0 TSQL …
DatabaseBackup - USER_DATABASES - LOG 1 sa 0 TSQL …
DatabaseIntegrityCheck - SYSTEM_DATABASES 1 sa 0 TSQL …
DatabaseIntegrityCheck - USER_DATABASES 1 sa 0 TSQL …
IndexOptimize - USER_DATABASES 1 sa 0 TSQL …
Output File Cleanup 1 sa 0 CMDEXEC …
sp_delete_backuphistory 1 sa 0 TSQL …
sp_purge_jobhistory 1 sa 0 TSQL …
syspolicy_purge_history 1 sa 1 TSQL,TSQL,PowerShell- 11 Jobs der Wartungslösung, 10 mit T-SQL-Schritt und „Output File Cleanup“ mit einem CmdExec-Schritt.
syspolicy_purge_historygehört zu SQL Server selbst. - Alle Jobs sind aktiv, aber ohne Zeitplan. Ohne
-AutoScheduleJobslaufen sie erst, wenn Sie Zeitpläne anlegen.-AutoScheduleJobshaben wir nicht geprüft. - Die Ausgabedatei verwendet Agent-Platzhalter: Protokollordner, Jobname, Schritt, Datum und Uhrzeit. Auf dem Server hieß eine Datei danach
DatabaseBackup - USER_DATABASES - FULL_1_20261118_93852.txt.
Gestartet haben wir vier der Jobs mit Start-DbaAgentJob -Wait:
Name CurrentRunStatus LastRunOutcome
---- ---------------- --------------
CommandLog Cleanup Idle Succeeded
DatabaseBackup - USER_DATABASES - FULL Idle Succeeded
DatabaseIntegrityCheck - SYSTEM_DATABASES Idle Succeeded
Output File Cleanup Idle SucceededDie Protokolltabelle dbo.CommandLog enthielt danach Sicherungen, RESTORE VERIFYONLY, DBCC CHECKDB und Löschvorgänge, alle ohne Fehler. Der Job IndexOptimize - USER_DATABASES wird mit installiert. Ob, wann und mit welchen Schwellen Sie ihn einplanen, ist eine eigene Frage; dazu Indexwartung verstehen.
Parameter seit Version 2.8.0. -Compress, -Verify und -CheckSum sind seit 2.8.0 keine Schalter mehr, sondern nehmen die Werte Default, ForceOn, ForceOff oder Remove (Release-Notiz und Quelltext 2.9.1, Zeilen 294–314). Ältere Installationsskripte, die diese Parameter als Schalter setzen, brauchen deshalb eine Anpassung. Diese Parameter haben wir nicht ausprobiert.
Abweichung unter Linux
Unter Linux legte dieselbe Installation auf 2017, 2019, 2022 und 2025 je 10 Jobs an, alle mit T-SQL-Schritten. „Output File Cleanup“ fehlt, weil der Agent dort keine Betriebssystembefehle ausführt. Sicherung, Prüfung und Bereinigung liefen fehlerfrei. Die Ausgabedateien liegen unter /var/opt/mssql/log und sind UTF-16-kodiert. Mehr zum Betrieb unter Linux steht in SQL Server unter Linux für Windows-Admins.
3 · -LocalFile: was tatsächlich installiert wird
Laut Hilfe ist -LocalFile für Server ohne Internet gedacht und für den Fall, dass Sie eine bestimmte Version installieren wollen. Wir haben verschiedene Archive auf eine Testdatenbank installiert, jeweils mit leerem Zwischenspeicher, und danach die Version abgefragt. Unter Windows und Linux war das Ergebnis gleich:
| Fall | -LocalFile | Ergebnis | installierte Version |
|---|---|---|---|
| A | ola-main.zip (Ordner …-main) | Success | 2026-09-12 aus dem Archiv |
| B | Tag-Archiv 20260912_150238 | Success | 2026-09-12 aus der Kopie im Modul |
| C | Tag-Archiv 20260823_144645 | Success | 2026-09-12 statt 2026-08-23 |
| D | Datei gibt es nicht | Success | 2026-09-12 aus der Kopie im Modul |
| E | Archiv aus C, Zwischenspeicher aus A vorhanden | Success | 2026-08-23 |
| G | Archiv aus C, in …-main umgepackt | Success | 2026-08-23 |
| F | wie G, Netzprofil ohne Internet (simuliert, nur Windows) | Success | 2026-09-12 statt 2026-08-23 |
In den Fällen B, C, D und F kam keine Warnung. Nur mit -Verbose erschien eine Zeile, die für Fall D so aussah:
VERBOSE: [09:37:24][Install-DbaMaintenanceSolution] No internet connection found, using included copy of Maintenance Solution.Die Meldung passt nicht zur Ursache: Der Server hatte Internet. Was im Quelltext von 2.9.1 dahintersteht:
- Nur
…-mainwird angenommen.Save-DbaCommunitySoftwareerwartet im Archiv den Ordnersql-server-maintenance-solution-main(Zeilen 433 und 441). Ein Tag-Archiv von Olas GitHub-Seite enthält stattdessensql-server-maintenance-solution-20260823_144645. - Jeder Fehler fällt still auf die Kopie im Modul zurück (Zeilen 386–396), auch bei einer fehlenden Datei. Wer gezielt eine ältere Fassung installieren will, bekommt die des Moduls (Fall C).
- Mit vorhandenem Zwischenspeicher landet das Archiv als Unterordner darin. Danach lagen dort zwei
MaintenanceSolution.sql. Weil der Befehl die Dateien rekursiv liest (Zeile 537), gewinnt die zuletzt gelesene Fassung (Fall E). Auch spätere Installationen aus diesem Zwischenspeicher sind davon betroffen. - Nur unter Windows: ohne Internet im Netzprofil zählt
-LocalFilegar nicht. MeldetGet-NetConnectionProfilekeine Internetverbindung, setzt der Befehl die Kopie im Modul, bevor er-LocalFileüberhaupt ansieht (Zeilen 363–380). Das haben wir simuliert, indem wirGet-NetConnectionProfilein der Sitzung überschrieben haben. Ein echter Server ohne Internet steht noch aus. Betroffen wäre genau der Fall, für den die Hilfe-LocalFileempfiehlt.
Was im Lab funktioniert hat: main.zip verwenden oder ein Tag-Archiv in einen Ordner …-main umpacken (Fall G):
# Tag-Archiv in einen Ordner "sql-server-maintenance-solution-main" umpacken
Expand-Archive C:\lab\pakete\ola-20260823_144645.zip -DestinationPath C:\lab\w2\umpacken\x -Force
Rename-Item (Get-ChildItem C:\lab\w2\umpacken\x -Directory | Select-Object -First 1).FullName 'sql-server-maintenance-solution-main'
Add-Type -AssemblyName System.IO.Compression.FileSystem
[IO.Compression.ZipFile]::CreateFromDirectory('C:\lab\w2\umpacken\x', 'C:\lab\w2\umpacken\ola-20260823-als-main.zip')
Install-DbaMaintenanceSolution -SqlInstance SQLSRV-01 -Database ola_g -LocalFile C:\lab\w2\umpacken\ola-20260823-als-main.zipDie Versionsabfrage aus Abschnitt 2 ergab danach Version: 2026-08-23 14:46:45. Weil derselbe Aufruf ohne Internetprofil wieder die Kopie im Modul installiert (Fall F), gilt in jedem Fall: Version nach der Installation abfragen. Bei mehreren Instanzen lässt sich dieselbe Abfrage über eine Liste von Instanzen laufen.
Stand 18.11.2026 war der stille Rückfall im Projekt nicht gemeldet. Nach dem Fall ohne Internetprofil haben wir nicht eigens gesucht.
4 · First Responder Kit und sp_WhoIsActive
Beide Befehle haben im Lab mit den Release-Archiven der Projekte funktioniert. dbatools benennt deren Ordner beim Entpacken passend um.
$alle = 'SQLSRV-01', 'SQLSRV-01\SQL2'
Install-DbaFirstResponderKit -SqlInstance $alle -Database master -LocalFile C:\lab\pakete\frk-20261114.zipAuf beiden Instanzen meldete der Befehl zwölf Objekte als Installed: sp_Blitz, sp_BlitzAnalysis, sp_BlitzBackups, sp_BlitzCache, sp_BlitzFirst, sp_BlitzIndex, sp_BlitzLock, sp_BlitzWho, sp_DatabaseRestore, sp_ineachdb, sp_kill und SqlServerVersions. Die Skripte im Ordner Deprecated installiert er nicht. Die Version liefert sp_Blitz selbst:
DECLARE @v varchar(30), @d datetime;EXEC dbo.sp_Blitz @Version = @v OUTPUT, @VersionDate = @d OUTPUT, @VersionCheckMode = 1;SELECT @v AS v, CONVERT(char(10), @d, 23) AS d;Im Lab ergab das 8.35 und 2026-11-14, auf Windows wie auf allen vier Linux-Versionen.
Install-DbaWhoIsActive -SqlInstance $alle -Database master -LocalFile C:\lab\pakete\whoisactive-20260409.zip |
Select-Object SqlInstance, Name, Version, StatusSqlInstance Name Version Status
----------- ---- ------- ------
SQLSRV-01 sp_WhoIsActive 2200.20260409\r\n(C) Installed
SQLSRV-01\SQL2 sp_WhoIsActive 2200.20260409\r\n(C) Installed- Die Spalte
Versionenthält einen Zeilenumbruch und(C)aus dem Skriptkopf (oben als\r\ndargestellt). Für einen Bericht schneiden Sie den Text am Zeilenumbruch ab. - Je nach SQL-Server-Version eine andere Datei. Das Archiv enthält eigene Fassungen für ältere Versionen. Auf 2017 und 2019 installierte der Befehl die Datei aus dem Ordner
2019(1219.20260409), ab 2022 die Datei aus der Wurzel (2200.20260409). Gemessen haben wir das für 2017 und 2019 nur unter Linux. - Eine einzelne
.sql-Datei reicht nur ab SQL Server 2022. Für 2017 und 2019 sucht der Befehl die Datei im Unterordner2019und bricht ohne Installation mit einer Warnung ab:No SQL file found in /tmp/cache-wia-sql-sql2017/WhoIsActive.Geben Sie deshalb das ganze Release-Archiv an.
Zum Aufrufen gibt es Invoke-DbaWhoIsActive; das haben wir nicht ausgeführt. Wie Sie Sperren und Blockierungen lesen, die sp_WhoIsActive zeigt, erklärt unser Locking-Hub.
5 · Jobs auf andere Instanzen kopieren
Für den Test haben wir auf der Quellinstanz sechs Jobs angelegt:
dbt_cmdexecmit CmdExec-Schritt, Ausgabedatei und Zeitplannachts,dbt_powershellmit PowerShell-Schritt und Zeitplannachts_ps,dbt_proxymit CmdExec-Schritt unter einem Proxy-Konto,dbt_tsql_fehlermit einem T-SQL-Schritt, der absichtlich scheitert, und stündlichem Zeitplanstuendlich,dbt_deaktiviert, schon auf der Quelle deaktiviert,dbt_besitzermit einem Besitzer-Login, den es nur auf der Quelle gibt.
Den Proxy und den Login gab es auf dem Ziel nicht. Probieren Sie den Aufruf zuerst mit -WhatIf aus. Kopiert haben wir so:
Copy-DbaAgentJob -Source SQLSRV-01 -Destination SQLSRV-01\SQL2 `
-Job dbt_cmdexec, dbt_powershell, dbt_proxy, dbt_tsql_fehler, dbt_deaktiviert, dbt_besitzer `
-DisableOnDestination |
Where-Object { $_ } |
Format-Table DestinationServer, Name, Type, Status, NotesDestinationServer Name Type Status Notes
----------------- ---- ---- ------ -----
SQLSRV-01\SQL2 dbt_besitzer Agent Job Skipped Job is dependent on login jobbesitzer
SQLSRV-01\SQL2 dbt_cmdexec Agent Job Successful
SQLSRV-01\SQL2 dbt_deaktiviert Agent Job Successful
SQLSRV-01\SQL2 dbt_powershell Agent Job Successful
SQLSRV-01\SQL2 dbt_proxy Agent Job Skipped Job is dependent on proxy dbt_proxy
SQLSRV-01\SQL2 dbt_tsql_fehler Agent Job Successful- Fehlende Abhängigkeiten führen zu
Skippedmit einer klaren Begründung. Laut Quelltext gilt das außer für Besitzer und Proxy auch für fehlende Operatoren und Datenbanken; Jobs von Wartungsplänen überspringt der Befehl ebenfalls. Einen fehlenden Besitzer übergeht er nur mit-Force; das haben wir nicht geprüft. Legen Sie Logins und Proxys vorher auf dem Ziel an. - Ein zweiter Lauf überspringt vorhandene Jobs:
Already exists on destination. Where-Object { $_ }filtert leere Objekte, die 2.9.1 zwischen die Ergebniszeilen schreibt. Das ist nach 2.9.1 behoben (#10795).
Der Job ist aus, die Zeitpläne nicht
So sahen die kopierten Jobs auf dem Ziel aus:
Get-DbaAgentJob -SqlInstance SQLSRV-01\SQL2 -Job dbt_cmdexec, dbt_deaktiviert, dbt_powershell, dbt_tsql_fehler |
Format-Table Name, IsEnabled, HasSchedule,
@{ n = 'Schedules'; e = { ($_.JobSchedules | ForEach-Object { "$($_.Name)=$($_.IsEnabled)" }) -join ',' } }Name IsEnabled HasSchedule Schedules
---- --------- ----------- ---------
dbt_cmdexec False True nachts=True
dbt_deaktiviert False False
dbt_powershell False True nachts_ps=True
dbt_tsql_fehler False True stuendlich=True-DisableOnDestination schaltet den Job ab, nicht seine Zeitpläne. Solange der Job aus ist, hält das ihn an; in msdb stand für alle drei Zeitpläne kein nächster Lauf (next_run_date 0). Wer den Job später auf dem Ziel einschaltet, schaltet damit aber auch seine Zeitpläne scharf. Außerdem legt der Befehl den Job zunächst mit dem Zustand der Quelle an und schaltet ihn erst danach ab (Quelltext 2.9.1, Zeilen 536–537 und 576–582). Einen Lauf in dieser kurzen Lücke haben wir nicht beobachtet und nicht gezielt herbeigeführt.
Für einen Umzug heißt das: Kopieren Sie mit -DisableOnDestination, prüfen Sie Jobs und Zeitpläne auf dem Ziel und schalten Sie am Umschalttag bewusst um, auf der Quelle aus und auf dem Ziel an.
CmdExec, PowerShell und Proxy
Unter Windows liefen alle drei Schrittarten auf beiden Instanzen. Den Proxy-Job haben wir nur auf der Quelle gestartet, weil er nicht kopiert worden war. Die Verlaufsmeldungen:
SQLSRV-01 | dbt_cmdexec | Succeeded | Executed as user: NT Service\SQLSERVERAGENT. hallo aus cmdexec SQLSRV-01. Process Exit Code 0. The step succeeded.
SQLSRV-01 | dbt_powershell | Succeeded | Executed as user: NT Service\SQLSERVERAGENT. hallo aus PowerShell 5.1.20348.558 auf SQLSRV-01. Process Exit Code 0. The step succeeded.
SQLSRV-01 | dbt_proxy | Succeeded | Executed as user: SQLSRV-01\dbt_proxyuser. sqlsrv-01\dbt_proxyuser. Process Exit Code 0. The step succeeded.
SQLSRV-01\SQL2 | dbt_cmdexec | Succeeded | Executed as user: NT Service\SQLAgent$SQL2. hallo aus cmdexec SQLSRV-01. Process Exit Code 0. The step succeeded.
SQLSRV-01\SQL2 | dbt_powershell | Succeeded | Executed as user: NT Service\SQLAgent$SQL2. hallo aus PowerShell 5.1.20348.558 auf SQLSRV-01. Process Exit Code 0. The step succeeded.Der PowerShell-Schritt des Agents lief mit Windows PowerShell 5.1, nicht mit PowerShell 7.
Abweichung unter Linux
Unter Linux ließen sich CmdExec-Jobs anlegen und von 2019 nach 2017, 2022 und 2025 kopieren. Copy-DbaAgentJob prüft das Subsystem nicht und meldete Successful. Erst bei der Ausführung scheiterte der Schritt, auf allen vier Versionen gleich:
Running requested program is not allowed. The step failed.Der Agent lädt das Subsystem zwar, Microsoft führt CmdExec und PowerShell unter Linux aber als nicht unterstützt. Wer Jobs von Windows auf Linux kopiert, sollte sie vorher nach Subsystemen durchsehen, etwa mit der Abfrage aus Abschnitt 2. -DisableOnDestination, die übersprungenen Abhängigkeiten und die Filter aus Abschnitt 6 verhielten sich unter Linux genauso wie unter Windows.
6 · Jobs suchen und fehlgeschlagene Schritte finden
Find-DbaAgentJob sucht über viele Instanzen nach Jobs mit bestimmten Eigenschaften. Jeder Filter für sich lieferte im Lab das Erwartete. Kombiniert nicht:
| Aufruf (beide Instanzen) | Treffer bei unseren Testjobs |
|---|---|
-IsFailed | dbt_tsql_fehler auf beiden Instanzen |
-IsDisabled | dbt_deaktiviert auf der Quelle, alle vier kopierten Jobs auf dem Ziel |
-IsNotScheduled | dbt_besitzer, dbt_deaktiviert, dbt_proxy auf der Quelle, dbt_deaktiviert auf dem Ziel |
-IsDisabled -IsNotScheduled | dieselben wie -IsNotScheduled |
-IsFailed -IsDisabled | dieselben wie -IsDisabled |
-StepName echo | dbt_cmdexec auf beiden Instanzen |
Bei mehreren Bedingungsfiltern setzt jeder Filter das Ergebnis neu, und es gilt nur der im Code letzte (Quelltext 2.9.1, Zeilen 271–317). Das ist im Projekt als #10853 gemeldet und war am 18.11.2026 offen. Unter Linux galt dasselbe auf allen vier Versionen. Den Namensfilter mit einer Bedingung zu verbinden, funktionierte dort: -JobName dbt* -IsNotScheduled lieferte genau die ungeplanten Testjobs. Für weitere Bedingungen rufen Sie den Befehl mit einem Filter auf und filtern das Ergebnis selbst nach.
-LastUsed findet nicht, was die Hilfe verspricht. Laut Hilfe findet -LastUsed 1 Jobs, die seit einem Tag nicht erfolgreich gelaufen sind. Im Lab lieferte es nur Jobs, die noch nie gelaufen waren, darunter die ungeplanten Ola-Jobs. Den am selben Tag fehlgeschlagenen dbt_tsql_fehler fand es nicht. Der Befehl prüft das Datum des letzten Laufs, nicht dessen Erfolg. Stand 18.11.2026 war das im Projekt nicht gemeldet. Fehlgeschlagene Jobs finden Sie mit -IsFailed.
Verlauf über alle Instanzen
Get-DbaAgentJobHistory nimmt eine Liste von Instanzen und Jobs und liefert den Verlauf in einem Aufruf. Zeilen mit StepID 0 fassen den ganzen Job zusammen; für die Meldungen der Schritte filtern Sie sie weg:
Get-DbaAgentJobHistory -SqlInstance $alle -Job dbt_cmdexec, dbt_powershell, dbt_proxy, dbt_tsql_fehler |
Where-Object StepID -gt 0 |
ForEach-Object { "$($_.SqlInstance) | $($_.Job) | $($_.Status) | $($_.Message)" }Neben den Erfolgsmeldungen aus Abschnitt 5 kam für den absichtlich scheiternden Job:
SQLSRV-01 | dbt_tsql_fehler | Failed | Executed as user: NT SERVICE\SQLSERVERAGENT. dbt: gewollter Fehler [SQLSTATE 42000] (Error 50000). The step failed.
SQLSRV-01\SQL2 | dbt_tsql_fehler | Failed | Executed as user: NT SERVICE\SQLAgent$SQL2. dbt: gewollter Fehler [SQLSTATE 42000] (Error 50000). The step failed.Ohne -EndDate nimmt der Befehl die Uhr des Rechners, auf dem dbatools läuft. Liegen Client und Instanz in verschiedenen Zeitzonen, kann das den Zeitraum verschieben; dazu ist ein Pull Request offen (#10849). Im Lab gab es keinen Zeitzonenunterschied.
7 · Ausgabedateien der Jobs finden
Viele Jobs schreiben ihre ausführliche Ausgabe in eine Datei, Olas Jobs ebenso. Get-DbaAgentJobHistory -WithOutputFile ergänzt dafür die Spalten OutputFileName und RemoteOutputFileName. Für einen Ola-Job auf dem Windows-Server:
Get-DbaAgentJobHistory -SqlInstance SQLSRV-01 -Job 'DatabaseBackup - USER_DATABASES - FULL' -WithOutputFile |
Where-Object StepID -gt 0 |
Format-List Job, Status, OutputFileName, RemoteOutputFileNameJob : DatabaseBackup - USER_DATABASES - FULL
Status : Succeeded
OutputFileName : C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\Log\$(ESCAPE_SQUOTE(JOBNAME))_1_20261118_93852.txt
RemoteOutputFileName : \\SQLSRV-01\C$\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\Log\$(ESCAPE_SQUOTE(JOBNAME))_1_20261118_93852.txt- Den Jobnamen löst der Befehl nicht auf. Ordner, Schritt, Datum und Uhrzeit sind ersetzt,
$(ESCAPE_SQUOTE(JOBNAME))steht noch im Namen. Beide Pfade gibt es so nicht,Test-PathergabFalse. Die echte Datei hießDatabaseBackup - USER_DATABASES - FULL_1_20261118_93852.txt. Bei unserem eigenen Job mit Platzhalter war es genauso. Die Hilfe verspricht, die Platzhalter aufzulösen. Stand 18.11.2026 war das im Projekt nicht gemeldet. Bis dahin setzen Sie den Jobnamen selbst ein. RemoteOutputFileNameführt über die AdministratorfreigabeC$. Wer die Datei von einem anderen Rechner aus öffnen will, braucht dort Administratorrechte.- Unter Linux ist
RemoteOutputFileNamederselbe lokale Pfad wieOutputFileName, kein UNC-Pfad. Der Jobname bleibt dort ebenso ungelöst. Ein Job mit festem Dateinamen ohne Platzhalter ergab unter Linux den richtigen Pfad.
8 · So halten Sie Jobs und Skripte gleich
- Herkunft festhalten: Projekt, Release oder Tag, Prüfsumme und Lizenz je Skript; installieren mit
-LocalFile, zuerst auf einer Testinstanz. - Version abfragen statt
Successglauben: Olas Prozedurkopf,sp_Blitz @VersionCheckMode = 1, die Versionsspalte vonInstall-DbaWhoIsActive. Bei Ola gilt das besonders für Server ohne Internet. - Zwischenspeicher im Blick behalten: Ohne
-Forceoder-LocalFileverwendet dbatools, was schon im Datenordner liegt. - Jobs mit
-DisableOnDestinationkopieren und danach Zeitpläne und übersprungene Jobs prüfen. Logins (Teil 5) und Proxys vorher anlegen. - Pro Aufruf von
Find-DbaAgentJobeine Bedingung, alles Weitere selbst filtern. - Ausgabedateien: den Jobnamen selbst in den Pfad einsetzen.
- Unter Linux: keine CmdExec- oder PowerShell-Schritte, auch wenn das Kopieren gelingt.
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, lokal ausgeführt. Die Wartungslösung mit Jobs, die
-LocalFile-Fälle A bis G, First Responder Kit, sp_WhoIsActive, sechs eigene Jobs mit Kopie auf die zweite Instanz, Verlauf, Ausgabedateien undFind-DbaAgentJob. Je Fall ein Lauf. Die VM hatte eine vCPU; Laufzeiten nennen wir deshalb nicht. - Simuliert: Fall F (Netzprofil ohne Internet) durch eine überschriebene Funktion
Get-NetConnectionProfilein der Sitzung. Der Codepfad entspricht dem Quelltext; ein echter Server ohne Internet ist nicht geprüft. - Unter Linux gemessen (18.11.2026): dbatools 2.9.1 unter PowerShell 7.6.8 gegen SQL Server 2017 CU31, 2019 CU32, 2022 CU27 und 2025 CU9 in Linux-Containern mit SQL Server Agent. Dieselben Archive, die Fälle A bis E, CmdExec-Jobs mit Kopie von 2019 auf die übrigen Versionen, sp_WhoIsActive auf 2017 und 2019.
- Nur aus dem Quelltext: Überspringen bei fehlenden Operatoren und Datenbanken und bei Wartungsplänen, die neue Parameterform von
-Compress,-Verifyund-CheckSum. - Nicht gemessen: zwei getrennte Windows-Server und Domänenkonten,
-AutoScheduleJobs,-ReplaceExisting,Update-DbaMaintenanceSolution,Copy-DbaAgentJob -Force, die Ausgabe von-WhatIf,Invoke-DbaWhoIsActive, Zeitzonenunterschiede zwischen Client und Instanz, SQL Server 2017, 2019 und 2025 unter Windows.
Weiterlesen
- dbatools: Install-DbaMaintenanceSolution, Install-DbaFirstResponderKit, Install-DbaWhoIsActive, Copy-DbaAgentJob, Find-DbaAgentJob, Get-DbaAgentJobHistory (Hilfe mit Beispielen).
- Community-Projekte: SQL Server Maintenance Solution von Ola Hallengren (GitHub), First Responder Kit von Brent Ozar Unlimited, sp_WhoIsActive von Adam Machanic.
- Microsoft Learn: Editionen und Komponenten von SQL Server 2022 unter Linux (Agent-Subsysteme).
- Bei PSG: Indexwartung verstehen, Locking-Hub, SQL Server unter Linux für Windows-Admins, Open Source für SQL Server, dbatools-Übersicht.