v1.8.12.0: New-sqmOlaUsrDbBackupJob - explicit -BackupDirectory no longer gets \Usr-db appended

An explicitly passed -BackupDirectory was always suffixed with \Usr-db, even
when the caller supplied the full intended target path. Now \Usr-db is only
appended to auto-detected paths (registry / SMO BackupDirectory / default);
an explicit -BackupDirectory is used verbatim.

Verified on DEV02: -BackupDirectory "C:\Temp\ExplicitTestPath" resolves to
that exact path with no suffix.

Author: Uwe Janke

CHANGELOG.md

@@ -1,5 +1,18 @@
 # sqmSQLTool — Changelog
 
+## [1.8.12.0] — 2026-07-02
+
+### Bugfix
+
+**`New-sqmOlaUsrDbBackupJob`** — expliziter `-BackupDirectory` wurde ueberschrieben
+- Bisher wurde an JEDEN ermittelten Backup-Pfad `\Usr-db` angehaengt, auch wenn
+  der Aufrufer `-BackupDirectory` explizit als vollstaendigen Zielpfad uebergeben
+  hat. Fix: `\Usr-db` wird nur noch an automatisch ermittelte Pfade (Registry /
+  `sqlSrv.BackupDirectory` / Default) angehaengt; ein explizit gesetzter
+  `-BackupDirectory` wird unveraendert als Zielpfad verwendet.
+- Verifiziert auf DEV02: `-BackupDirectory "C:\Temp\ExplicitTestPath"` ergibt
+  exakt diesen Pfad ohne Suffix.
+
 ## [1.8.11.0] — 2026-07-02
 
 ### Bugfix

Public/New-sqmOlaUsrDbBackupJob.ps1

@@ -27,8 +27,9 @@
     PSCredential for the SQL connection.
 
 .PARAMETER BackupDirectory
-    Backup base directory. User databases are backed up to <BackupDirectory>\Usr-db.
-    Default: automatically determined from SQL Server.
+    Backup target directory. When omitted, the base directory is automatically determined
+    from SQL Server and '\Usr-db' is appended. When explicitly specified, the given path is
+    used as-is (no '\Usr-db' is appended) — pass the full, final backup path.
 
 .PARAMETER Databases
     Database filter for Ola. E.g. 'USER_DATABASES', 'ALL_DATABASES', or
@@ -430,7 +431,17 @@ function New-sqmOlaUsrDbBackupJob
 				if (-not $effBackupDir) { $effBackupDir = $sqlSrv.BackupDirectory }
 			}
 			if (-not $effBackupDir) { $effBackupDir = 'C:\Program Files\Microsoft SQL Server\MSSQL\Backup' }
-			$usrBackupDir = "$effBackupDir\Usr-db"
+
+			# Explizit uebergebener -BackupDirectory wird unveraendert als Zielpfad verwendet;
+			# nur bei automatisch ermitteltem Pfad wird '\Usr-db' angehaengt.
+			if ($PSBoundParameters.ContainsKey('BackupDirectory') -and $BackupDirectory)
+			{
+				$usrBackupDir = $BackupDirectory
+			}
+			else
+			{
+				$usrBackupDir = "$effBackupDir\Usr-db"
+			}
 			Invoke-sqmLogging -Message "Backup-Verzeichnis fuer User-Datenbanken: $usrBackupDir" -FunctionName $functionName -Level "INFO"
 
 			# 3. SA-Login und Job-Kategorie

sqmSQLTool.psd1

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