Open Source · dbatools

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.

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

Teil 8 · Agent-JobsSQL-Abfragen 2Lab Windows · Linux
Install-DbaMaintenanceSolution -LocalFileLab · Windows und LinuxArchiv mit Ordner …-mainola-main.zipinstalliert: 2026-09-12 aus dem ArchivTag-Archiv von Olas GitHub-Seite20260823_144645Kopie im Modul2026-09-12Success2026-09-12 statt 2026-08-23

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 -LocalFile installieren und danach die installierte Version abfragen. Die Erfolgsmeldung allein sagt nicht, welche Fassung auf dem Server liegt.
  • -LocalFile bei Ola Hallengren: dbatools verwendet nur ein Archiv mit dem Ordner sql-server-maintenance-solution-main, wie es main.zip enthält. Ein Tag-Archiv von Olas GitHub-Seite oder eine fehlende Datei verwirft der Befehl still, installiert seine mitgelieferte Kopie und meldet Success. Meldet Windows im Netzprofil kein Internet, ignoriert er -LocalFile ganz (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 -DisableOnDestination schaltet die kopierten Jobs ab, ihre Zeitpläne bleiben aktiv. Fehlt auf dem Ziel der Besitzer-Login oder der Proxy, wird der Job mit Skipped übersprungen.
  • Find-DbaAgentJob kombiniert Filter nicht: Bei mehreren Bedingungen gilt nur eine (offen als #10853). -LastUsed findet nie gelaufene Jobs, nicht fehlgeschlagene.
  • Ausgabedateien: Get-DbaAgentJobHistory -WithOutputFile lässt den Jobnamen im Dateinamen als Platzhalter stehen. Unter Windows kommt der Pfad zusätzlich als UNC-Pfad über die Administratorfreigabe C$.

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_BlitzIndex und 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

  1. Release von der Projektseite laden und als Datei ablegen, auch für Server ohne Internet.
  2. Prüfsumme notieren, zum Beispiel mit Get-FileHash -Algorithm SHA256.
  3. Mit -LocalFile installieren, zuerst auf einer Testinstanz.
  4. 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
DateiQuelleStandSHA-256
ola-main.zipMaintenance Solution, archive/refs/heads/main.zipVersion 2026-09-12 15:02:38e0cd31305a946ad1f86c09a13d215956a2e3ba25fb9a94c5c75355886d5e22e0
ola-20260912_150238.zipdto., Tag 20260912_150238gleiche Fassung wie main4a3598d595f7bacd6edd2e96c610bd3329677e1528efeadcada02fcaa899f20c
ola-20260823_144645.zipdto., Tag 20260823_144645Version 2026-08-23 14:46:4548583527a9ed4326c6cef898a1db720460e49d547d1cb513a2252c2839666008
frk-20261114.zipFirst Responder Kit, Release 202611148.35122fea767442f5c87dc4fc0ce900ca57671e260df9e23d452eb3be981e792957
whoisactive-20260409.zipsp_WhoIsActive, Release 20260409202604092a486774b0efd18a7ba2a45b6bbff79d32c9a9ace6da679ed661aeb500efa125

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 -Force oder -LocalFile weiterverwendet. 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ällt Install-DbaMaintenanceSolution zurück, wenn etwas nicht klappt (Abschnitt 3).
  • Der Ordner muss existieren. Zeigte Path.DbatoolsData im Lab auf einen nicht vorhandenen Ordner, installierte Install-DbaMaintenanceSolution nichts und meldete weder Ergebnis noch Warnung. Install-DbaFirstResponderKit brach mit Cannot 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 -Verbose
Ausgabe im Lab
VERBOSE: 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   Success

Ohne -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:]+').Value
Ausgabe im Lab
Version: 2026-09-12 15:02:38

Diese 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):

Ausgabe im Lab
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_history gehört zu SQL Server selbst.
  • Alle Jobs sind aktiv, aber ohne Zeitplan. Ohne -AutoScheduleJobs laufen sie erst, wenn Sie Zeitpläne anlegen. -AutoScheduleJobs haben 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:

Ausgabe im Lab
Name                                      CurrentRunStatus LastRunOutcome
----                                      ---------------- --------------
CommandLog Cleanup                                    Idle      Succeeded
DatabaseBackup - USER_DATABASES - FULL                Idle      Succeeded
DatabaseIntegrityCheck - SYSTEM_DATABASES             Idle      Succeeded
Output File Cleanup                                   Idle      Succeeded

Die 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-LocalFileErgebnisinstallierte Version
Aola-main.zip (Ordner …-main)Success2026-09-12 aus dem Archiv
BTag-Archiv 20260912_150238Success2026-09-12 aus der Kopie im Modul
CTag-Archiv 20260823_144645Success2026-09-12 statt 2026-08-23
DDatei gibt es nichtSuccess2026-09-12 aus der Kopie im Modul
EArchiv aus C, Zwischenspeicher aus A vorhandenSuccess2026-08-23
GArchiv aus C, in …-main umgepacktSuccess2026-08-23
Fwie G, Netzprofil ohne Internet (simuliert, nur Windows)Success2026-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:

Ausgabe im Lab
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 …-main wird angenommen. Save-DbaCommunitySoftware erwartet im Archiv den Ordner sql-server-maintenance-solution-main (Zeilen 433 und 441). Ein Tag-Archiv von Olas GitHub-Seite enthält stattdessen sql-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 -LocalFile gar nicht. Meldet Get-NetConnectionProfile keine Internetverbindung, setzt der Befehl die Kopie im Modul, bevor er -LocalFile überhaupt ansieht (Zeilen 363–380). Das haben wir simuliert, indem wir Get-NetConnectionProfile in der Sitzung überschrieben haben. Ein echter Server ohne Internet steht noch aus. Betroffen wäre genau der Fall, für den die Hilfe -LocalFile empfiehlt.

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

Die 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.zip

Auf 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, Status
Ausgabe im Lab
SqlInstance    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 Version enthält einen Zeilenumbruch und (C) aus dem Skriptkopf (oben als \r\n dargestellt). 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 Unterordner 2019 und 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_cmdexec mit CmdExec-Schritt, Ausgabedatei und Zeitplan nachts,
  • dbt_powershell mit PowerShell-Schritt und Zeitplan nachts_ps,
  • dbt_proxy mit CmdExec-Schritt unter einem Proxy-Konto,
  • dbt_tsql_fehler mit einem T-SQL-Schritt, der absichtlich scheitert, und stündlichem Zeitplan stuendlich,
  • dbt_deaktiviert, schon auf der Quelle deaktiviert,
  • dbt_besitzer mit 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, Notes
Ausgabe im Lab
DestinationServer 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 Skipped mit 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 ',' } }
Ausgabe im Lab
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:

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

Ausgabe im Lab
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
-IsFaileddbt_tsql_fehler auf beiden Instanzen
-IsDisableddbt_deaktiviert auf der Quelle, alle vier kopierten Jobs auf dem Ziel
-IsNotScheduleddbt_besitzer, dbt_deaktiviert, dbt_proxy auf der Quelle, dbt_deaktiviert auf dem Ziel
-IsDisabled -IsNotScheduleddieselben wie -IsNotScheduled
-IsFailed -IsDisableddieselben wie -IsDisabled
-StepName echodbt_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:

Ausgabe im Lab
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, RemoteOutputFileName
Ausgabe im Lab
Job                  : 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-Path ergab False. 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.
  • RemoteOutputFileName führt über die Administratorfreigabe C$. Wer die Datei von einem anderen Rechner aus öffnen will, braucht dort Administratorrechte.
  • Unter Linux ist RemoteOutputFileName derselbe lokale Pfad wie OutputFileName, 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 Success glauben: Olas Prozedurkopf, sp_Blitz @VersionCheckMode = 1, die Versionsspalte von Install-DbaWhoIsActive. Bei Ola gilt das besonders für Server ohne Internet.
  • Zwischenspeicher im Blick behalten: Ohne -Force oder -LocalFile verwendet dbatools, was schon im Datenordner liegt.
  • Jobs mit -DisableOnDestination kopieren und danach Zeitpläne und übersprungene Jobs prüfen. Logins (Teil 5) und Proxys vorher anlegen.
  • Pro Aufruf von Find-DbaAgentJob eine 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 und Find-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-NetConnectionProfile in 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, -Verify und -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

Weitere Teile der Reihe