Fixed host instances WMI query error when dealing with shutdown / restart

Dokumentation.md

@@ -1,7 +1,7 @@
 # BizTalk Platform Management Tool Dokumentation
 
 **Stand:** 2026-04-27
-**Implementierung:** C# WinForms, .NET Framework 4.7.1
+**Implementierung:** C# WinForms, .NET Framework 4.6.1
 **Archivierte PowerShell-Version:** `archive/powershell/BizTalkPlatformManagementTool.ps1`
 
 ## Zweck
@@ -40,10 +40,13 @@ Das BizTalk Platform Management Tool unterstützt kontrollierte Wartungsfenster
 - Dry-run ist standardmäßig aktiviert.
 - Echte Shutdown-/Restore-Aktionen verlangen bei deaktiviertem Dry-run eine zusätzliche Bestätigung.
 - Jede Operation schreibt Einträge in das sichtbare Operation Log.
+- Zusätzlich wird neben der EXE eine tägliche Logdatei `BizTalkPlatformManagementTool-yyyy-MM-dd.log` geschrieben.
+- Logdateien werden rollierend für den aktuellen Tag plus vier vorherige Tage vorgehalten.
 - Operationspläne werden vor Laufzeitänderungen gespeichert.
 - WMI-Methodenrückgaben werden geprüft.
 - Wartezeiten nutzen konfigurierbare Timeout- und Polling-Werte.
 - Host Instances auf anderen Servern werden übersprungen und als Warnung protokolliert.
+- Echte Shutdown-/Restore-Schritte protokollieren WMI-Klasse, Schlüssel, Zielobjekt und Methode, damit Fehler wie WMI-Query- oder Methodenfehler eindeutig zugeordnet werden können.
 
 ## Shutdown-Reihenfolge
 
@@ -73,6 +76,11 @@ Das BizTalk Platform Management Tool unterstützt kontrollierte Wartungsfenster
 - Nachher-Snapshots: `shutdown-after.json`, `restore-after.json`
 - Diff: `diff.json`, `diff.csv`, `diff.html`
 - Snapshot-Reports: `*.csv`, `*.hosts.csv`, `*.html`
+- Laufzeitlogs neben der EXE: `BizTalkPlatformManagementTool-yyyy-MM-dd.log`
+
+## Fehleranalyse
+
+Bei echten Shutdown- und Restore-Aktionen wird jeder Schritt vor der Ausführung mit Artefakttyp, WMI-Klasse, Schlüsselproperty, Schlüsselwert und Methodenname protokolliert. Die Objektauflösung verwendet eine breite `SELECT * FROM <class>`-Abfrage und filtert danach im Prozess auf den Schlüsselwert. Dadurch können Host-Instance-Namen und andere BizTalk-Namen mit Sonderzeichen keine ungültige WMI-WQL-`WHERE`-Query mehr erzeugen.
 
 ## Status Mapping
 
@@ -83,7 +91,7 @@ Das BizTalk Platform Management Tool unterstützt kontrollierte Wartungsfenster
 
 ## Anforderungen
 
-- Windows Server oder Administrationshost mit .NET Framework 4.7.1
+- Windows Server oder Administrationshost mit .NET Framework 4.6.1
 - BizTalk Server 2020 oder installierte BizTalk Administration Tools
 - Berechtigungen auf den WMI-Namespace `root\MicrosoftBizTalkServer`
-- Visual Studio mit .NET Framework 4.7.1 Developer Pack für Builds
+- Visual Studio mit .NET Framework 4.6.1 Developer Pack für Builds