1.9.3.0: Fix AlwaysOn-Job-Propagierung und sqm_BackupExclude-Werte-Sync auf Secondaries

- New-sqmOlaUsrDbBackupJob: Propagierung auf Secondaries lief nur bei JobStatus='Created',
  nicht bei 'Updated'/'AlreadyExists' - Secondaries blieben nach dem ersten Lauf ohne
  spaetere Aenderungen.
- Sync-sqmBackupExcludeTable: IsActive/Reason-Werte der Primary wurden nie per MERGE auf
  Secondaries uebertragen, nur die Datenbank-Liste strukturell abgeglichen.

Author: Uwe Janke

CHANGELOG.md

@@ -1,5 +1,32 @@
 # sqmSQLTool — Changelog
 
+## [1.9.3.0] — 2026-07-03
+
+### Fix: AlwaysOn-Propagierung fehlte/griff nicht zuverlaessig
+
+**Problem gemeldet:** Jobs fehlten auf Secondary-Repliken; `sqm_BackupExclude`-Aenderungen
+(IsActive/Reason, ueber `Show-sqmBackupExcludeForm` gesetzt) kamen nie auf Secondaries an.
+
+- **Fix `New-sqmOlaUsrDbBackupJob`**: die AlwaysOn-Job-Propagierung am Funktionsende pruefte nur
+  `JobStatus -eq 'Created'`. Bei jedem Folgelauf (Job existiert bereits auf der Primary ->
+  `JobStatus = 'Updated'` oder `'AlreadyExists'`) wurde die Bedingung `$false` und die
+  Propagierung auf Secondaries lief **gar nicht mehr** - Secondaries blieben nach dem allerersten
+  Lauf dauerhaft ohne die Jobs bzw. ohne spaetere Aenderungen (z.B. geaenderte Zeitplaene). Jetzt
+  wird bei `'Created'`, `'Updated'` UND `'AlreadyExists'` propagiert (New-sqmOlaUsrDbBackupJob ist
+  auf der Secondary ohnehin idempotent per `-Update`).
+- **Fix `Sync-sqmBackupExcludeTable`**: die AlwaysOn-Propagierung rief auf jeder Secondary nur
+  rekursiv `Sync-sqmBackupExcludeTable` auf - das erkennt dort ausschliesslich NEUE/geloeschte
+  Datenbanken lokal, uebertraegt aber **niemals** die vom Admin gesetzten `IsActive`/`Reason`-
+  Werte der Primary. Der DDL-Trigger (`Register-sqmBackupExcludeTrigger`) deckt nur
+  CREATE_DATABASE/DROP_DATABASE ab, ebenfalls keine Werte-Propagierung. Ergebnis: eine ueber die
+  GUI gesetzte Ausschluss-Entscheidung erreichte Secondaries **nie**, auch nicht ueber den
+  periodischen Sync-Job. Fix: nach dem strukturellen Abgleich wird der aktuelle Datenstand der
+  Primary jetzt zusaetzlich per `MERGE` (IsActive/Reason) auf jede Secondary uebertragen. Auf
+  DEV02 verifiziert (MERGE-Logik gegen eine Mock-Tabelle getestet: Aenderungen korrekt
+  uebernommen, neue Zeilen eingefuegt, nicht in der Primary-Liste enthaltene Zeilen unangetastet
+  gelassen, Escaping von Anfuehrungszeichen in `Reason` korrekt). Echte AlwaysOn-Propagierung
+  selbst ist auf DEV02 nicht End-to-End testbar (keine AG dort vorhanden).
+
 ## [1.9.2.0] — 2026-07-03
 
 ### Erweiterung

Public/New-sqmOlaUsrDbBackupJob.ps1

@@ -905,8 +905,12 @@ END
 			if (-not $ContinueOnError) { throw }
 		}
 
-		# AlwaysOn-Propagierung: erfolgreich erstellte Jobs auch auf Secondary-Repliken anlegen
-		if (-not $SkipAlwaysOnPropagation -and $jobDefinitions -and ($results | Where-Object { $_.JobStatus -eq 'Created' }))
+		# AlwaysOn-Propagierung: Jobs auch auf Secondary-Repliken anlegen/aktualisieren.
+		# Nicht nur bei 'Created' ausloesen - sonst propagiert ein spaeterer -Update-Lauf (JobStatus
+		# 'Updated') oder ein erneuter Lauf ohne Aenderung ('AlreadyExists') NIE auf die Secondaries,
+		# obwohl New-sqmOlaUsrDbBackupJob dort idempotent per -Update erneut aufgerufen wird - Ursache
+		# fuer fehlende/veraltete Jobs auf Secondaries nach dem allerersten Lauf.
+		if (-not $SkipAlwaysOnPropagation -and $jobDefinitions -and ($results | Where-Object { $_.JobStatus -in @('Created', 'Updated', 'AlreadyExists') }))
 		{
 			try
 			{

Public/Sync-sqmBackupExcludeTable.ps1

@@ -413,6 +413,17 @@ WHERE  r.replica_server_name <> @@SERVERNAME
 "@
 				$secondaries = Invoke-DbaQuery @connParams -Database master -Query $replicaQuery -ErrorAction SilentlyContinue
 
+				# Aktueller, endgueltiger Stand der PRIMARY nach allen obigen Aenderungen - wird unten
+				# per MERGE an jede Secondary GEPUSHT (nicht nur strukturell abgeglichen). Der
+				# rekursive Sync-sqmBackupExcludeTable-Aufruf allein erkennt auf der Secondary nur
+				# NEUE/geloeschte Datenbanken selbst, uebernimmt aber NIE die vom Admin ueber
+				# Show-sqmBackupExcludeForm gesetzten IsActive/Reason-Werte der Primary - das war die
+				# Ursache dafuer, dass Aenderungen an der Exclude-Liste nie auf Secondaries ankamen.
+				$primaryRows = if ($secondaries)
+				{
+					Invoke-DbaQuery @connParams -Database master -Query "SELECT DatabaseName, Reason, IsActive FROM master.dbo.sqm_BackupExclude" -ErrorAction Stop
+				}
+
 				foreach ($sec in $secondaries)
 				{
 					$secName = $sec.replica_server_name
@@ -428,14 +439,37 @@ WHERE  r.replica_server_name <> @@SERVERNAME
 
 						Sync-sqmBackupExcludeTable @secParams -ErrorAction Stop | Out-Null
 
+						if ($primaryRows)
+						{
+							$secConnParams = @{ SqlInstance = $secName }
+							if ($SqlCredential) { $secConnParams['SqlCredential'] = $SqlCredential }
+
+							$valuesSql = ($primaryRows | ForEach-Object {
+									$reasonSql = if ([string]::IsNullOrEmpty($_.Reason)) { 'NULL' } else { "N'$($_.Reason.Replace("'", "''"))'" }
+									"(N'$($_.DatabaseName.Replace("'", "''"))', $reasonSql, $([int][bool]$_.IsActive))"
+								}) -join ', '
+
+							$mergeSql = @"
+MERGE master.dbo.sqm_BackupExclude AS tgt
+USING (VALUES $valuesSql) AS src (DatabaseName, Reason, IsActive)
+ON tgt.DatabaseName = src.DatabaseName
+WHEN MATCHED AND (tgt.IsActive <> src.IsActive OR ISNULL(tgt.Reason, N'') <> ISNULL(src.Reason, N'')) THEN
+    UPDATE SET IsActive = src.IsActive, Reason = src.Reason
+WHEN NOT MATCHED BY TARGET THEN
+    INSERT (DatabaseName, Reason, IsActive, IsOrphaned) VALUES (src.DatabaseName, src.Reason, src.IsActive, 0);
+"@
+							Invoke-DbaQuery @secConnParams -Database master -Query $mergeSql -ErrorAction Stop
+							Invoke-sqmLogging -Message "AlwaysOn: IsActive/Reason-Werte der Primary auf '$secName' uebertragen ($($primaryRows.Count) Zeile(n))." -FunctionName $functionName -Level "INFO"
+						}
+
 						Invoke-sqmLogging -Message "AlwaysOn: Secondary '$secName' erfolgreich synchronisiert." -FunctionName $functionName -Level "INFO"
 						$results.Add([PSCustomObject]@{
 							SqlInstance  = $secName
 							DatabaseName = 'N/A'
 							Action       = 'AlwaysOnPropagated'
 							IsActive     = $null
 							IsOrphaned   = $null
-							Message      = "AlwaysOn Secondary '$secName' synchronisiert."
+							Message      = "AlwaysOn Secondary '$secName' synchronisiert (inkl. IsActive/Reason-Werte)."
 						})
 					}
 					catch

sqmSQLTool.psd1

@@ -17,7 +17,7 @@
 	RootModule			   = 'sqmSQLTool.psm1'
 
 	# Version number of this module.
-	ModuleVersion		   = '1.9.2.0'
+	ModuleVersion		   = '1.9.3.0'
 
 	# ID used to uniquely identify this module
 	GUID				   = 'c4b10ba2-aee2-4d8d-ad86-a6e97c346ba6'