WinForms tool for controlled Microsoft BizTalk Server 2020 platform operations during maintenance windows. The tool captures runtime snapshots, creates shutdown and restore plans, executes those plans in a safe order, and writes diff reports for validation.

Current State

Application: C# WinForms
Target framework: .NET Framework 4.7.1
Solution: BizTalkPlatformManagementTool.sln
Project: src/BizTalkPlatformManagementTool/BizTalkPlatformManagementTool.csproj
Primary namespace and assembly: BizTalkPlatformManagementTool
Legacy PowerShell archive: archive/powershell/BizTalkPlatformManagementTool.ps1

Features

Snapshot before and after downtime as JSON, CSV and HTML
Diff between before.json and after.json
Controlled shutdown from the current runtime state
Controlled restore from before.json
Host instance handling for the selected BizTalk server
Dry-run mode enabled by default
WMI access through root\MicrosoftBizTalkServer
No compile-time dependency on BizTalk ExplorerOM assemblies

Safe Usage

Start the app on a BizTalk server or a management host with WMI access.
Keep Dry run enabled.
Click Diagnose to verify WMI access.
Click Snapshot Before.
Click Shutdown and review shutdown-plan.json.
Disable Dry run only when the plan is correct.
After maintenance, click Restore using the saved before.json.
Click Snapshot After and Compare.

Operation Order

Shutdown:

Disable receive locations that were enabled.
Stop orchestrations that were started.
Stop send ports that were started.
Stop host instances that were started on the selected server.

Restore:

Start host instances that were previously started.
Restore send ports to Started, Stopped or Bound.
Restore orchestrations where safe.
Restore receive locations last.

Orchestrations that were Bound are deliberately left unchanged during restore to avoid accidentally making them Unbound.

Outputs

before.json, after.json
shutdown-plan.json, restore-plan.json
shutdown-after.json, restore-after.json
diff.json, diff.csv, diff.html
Snapshot sidecars: *.csv, *.hosts.csv, *.html

Build

Open BizTalkPlatformManagementTool.sln in Visual Studio on Windows with the .NET Framework 4.7.1 Developer Pack installed, then build the Release|Any CPU configuration.

The app targets .NET Framework 4.7.1 because BizTalk Server 2020 commonly runs in that Windows/.NET Framework operational environment.

README.md

BizTalk Platform Management Tool