Fix Invoke-sqmRestoreDatabase AG-check and Invoke-sqmLogging WhatIf leak (1.6.1.0)

- Invoke-sqmRestoreDatabase: Get-DbaAvailabilityGroup has no -Database parameter;
  the terminating parameter-binding error bypassed -ErrorAction SilentlyContinue and
  aborted the restore as GlobalError when the target DB already existed. Check AG
  membership via Get-DbaAgDatabase and reload the AG object by name.
- Invoke-sqmLogging: caller -WhatIf leaked via $WhatIfPreference into Out-File/New-Item,
  producing "Output to File" noise and writing no log. Both now run with -WhatIf:$false.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: Uwe Janke

CHANGELOG.md

@@ -1,5 +1,19 @@
 # sqmSQLTool — Changelog
 
+## [1.6.1.0] — 2026-06-22
+
+### 🔧 Fixes
+
+- **Invoke-sqmRestoreDatabase**: Brach bei existierender Ziel-Datenbank mit
+  „A parameter cannot be found that matches parameter name 'Database'" ab. Ursache war
+  `Get-DbaAvailabilityGroup -Database` (diesen Parameter gibt es nicht; der Parameter-Binding-Fehler
+  ist terminierend und wird von `-ErrorAction SilentlyContinue` nicht abgefangen). AG-Mitgliedschaft
+  wird jetzt über `Get-DbaAgDatabase` geprüft, das AG-Objekt über den AG-Namen nachgeladen.
+- **Invoke-sqmLogging**: `-WhatIf` des Aufrufers leakte über `$WhatIfPreference` in die
+  internen `Out-File`/`New-Item`-Aufrufe und erzeugte „What if: Output to File"-Rauschen, während
+  gar kein Log geschrieben wurde. Beide Aufrufe laufen jetzt mit `-WhatIf:$false` (Logging ist ein
+  Seitenkanal und darf nicht unter ShouldProcess fallen).
+
 ## [1.6.0.0] — 2026-06-21
 
 ### ✨ Neu

Private/Invoke-sqmLogging.ps1

@@ -38,15 +38,18 @@ function Invoke-sqmLogging
 			# Sicherstellung dass LogPath existiert (könnte nach Modulimport gelöscht worden sein)
 			if (-not (Test-Path $logPath -PathType Container))
 			{
-				New-Item -ItemType Directory -Path $logPath -Force -ErrorAction Stop | Out-Null
+				# -WhatIf:$false: Logging ist ein Seitenkanal und darf nicht unter ShouldProcess
+				# fallen. Sonst leakt ein -WhatIf des Aufrufers (via $WhatIfPreference) hier herein
+				# und erzeugt "What if: Output to File"-Rauschen statt zu schreiben.
+				New-Item -ItemType Directory -Path $logPath -Force -ErrorAction Stop -WhatIf:$false | Out-Null
 			}
 
 			$dateStamp = Get-Date -Format "yyyyMMdd"
 			$fileName = "sqmSQLTool_$($dateStamp)_$($FunctionName).log"
 			$fullPath = Join-Path $logPath $fileName
 
 			$timestamp = Get-Date -Format "HH:mm:ss"
-			"[$timestamp] [$Level] $Message" | Out-File -FilePath $fullPath -Append -Encoding UTF8 -ErrorAction Stop
+			"[$timestamp] [$Level] $Message" | Out-File -FilePath $fullPath -Append -Encoding UTF8 -ErrorAction Stop -WhatIf:$false
 		}
 		catch
 		{

Public/Invoke-sqmRestoreDatabase.ps1

@@ -229,12 +229,17 @@ function Invoke-sqmRestoreDatabase
 			{
 				Invoke-sqmLogging -Message "Datenbank '$DatabaseName' existiert auf $SqlInstance." -FunctionName $functionName -Level "INFO"
 
-				# Pruefen, ob die Datenbank in einer AG ist
-				$agCheck = Get-DbaAvailabilityGroup -SqlInstance $SqlInstance -SqlCredential $SqlCredential -Database $DatabaseName -ErrorAction SilentlyContinue
-				if ($agCheck)
+				# Pruefen, ob die Datenbank in einer AG ist.
+				# WICHTIG: Get-DbaAvailabilityGroup hat KEINEN -Database-Parameter. Ein -Database loest einen
+				# terminierenden Parameter-Binding-Fehler aus, den -ErrorAction SilentlyContinue NICHT abfaengt.
+				# Daher Mitgliedschaft ueber Get-DbaAgDatabase pruefen und das AG-Objekt (mit .Name) anschliessend
+				# ueber den AG-Namen nachladen.
+				$agDbCheck = Get-DbaAgDatabase -SqlInstance $SqlInstance -SqlCredential $SqlCredential -Database $DatabaseName -ErrorAction SilentlyContinue
+				if ($agDbCheck)
 				{
 					$isAGDatabase = $true
-					$availabilityGroup = $agCheck
+					$agName = ($agDbCheck | Select-Object -First 1).AvailabilityGroup
+					$availabilityGroup = Get-DbaAvailabilityGroup -SqlInstance $SqlInstance -SqlCredential $SqlCredential -AvailabilityGroup $agName -ErrorAction SilentlyContinue
 					Invoke-sqmLogging -Message "Datenbank ist Mitglied der AG '$($availabilityGroup.Name)'." -FunctionName $functionName -Level "INFO"
 					if (-not $KeepAlwaysOn)
 					{

sqmSQLTool.psd1

@@ -17,7 +17,7 @@
 	RootModule			   = 'sqmSQLTool.psm1'
 
 	# Version number of this module.
-	ModuleVersion		   = '1.6.0.0'
+	ModuleVersion		   = '1.6.1.0'
 
 	# ID used to uniquely identify this module
 	GUID				   = 'c4b10ba2-aee2-4d8d-ad86-a6e97c346ba6'
@@ -243,7 +243,7 @@
 			# IconUri = ''
 
 			# ReleaseNotes of this module
-			ReleaseNotes = 'See CHANGELOG.md and GitHub: https://github.com/JankeUwe/sqmSQLTool/releases/tag/v1.6.0.0'
+			ReleaseNotes = 'See CHANGELOG.md and GitHub: https://github.com/JankeUwe/sqmSQLTool/releases/tag/v1.6.1.0'
 
 			# External module dependencies
 			ExternalModuleDependencies = @('dbatools')