v1.19.0 — Navigation + resilience sweep: 20 fixes across 21 modules

ReturnToMainMenu checks added to 17 menu loops (iSCSI, Firewall Templates,
NTP, Disk Cleanup, BitLocker, ISO Download, Cluster Dashboard, VM Checkpoints,
VM Export/Import, Network Diagnostics, Hyper-V Replica, Storage Backends x5,
Settings). UNC path guards on disk space checks (VM Export, Checkpoints,
Deployment). slmgr.vbs paths use $env:SystemRoot. Defender $threats scope fix.
IPv6 disable error action corrected. Export VM cleanup adds Stop-Job. $Matches
convention fix. Test-Path -LiteralPath in exit cleanup. Removed unused
BITSPreferred variable.

Author: TheAbider

Changelog.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## v1.19.0
+
+- **Bug Fix:** "Home" navigation now works from all nested menus — added `ReturnToMainMenu` checks to 17 menu loops across iSCSI, Firewall Templates, NTP, Disk Cleanup, BitLocker, ISO Download, Cluster Dashboard, VM Checkpoints, VM Export/Import, Network Diagnostics, Hyper-V Replica, Storage Backends, and Settings.
+- **Bug Fix:** Disk space pre-checks no longer fail on UNC/network paths — VM Export, VM Checkpoints, and VM Deployment now guard against non-drive-letter paths (clusters with CSVs, SMB shares).
+- **Bug Fix:** Hardcoded `slmgr.vbs` paths replaced with `$env:SystemRoot` for non-standard Windows installations (21-Licensing).
+- **Bug Fix:** Defender threat count logged correctly when query fails — `$threats` initialized before try block to prevent false "Threats=1" in session log (17-DefenderExclusions).
+- **Bug Fix:** IPv6 disable now reports actual failures instead of silent success — changed from `SilentlyContinue` to `Stop` error action so the catch block is reachable (07-IPConfiguration).
+- **Bug Fix:** Export VM cleanup now properly stops orphaned background jobs before removing them (53-VMExportImport).
+- **Bug Fix:** `$Matches` automatic variable captured immediately per project convention (19-NTPConfiguration).
+- **Bug Fix:** `Test-Path` calls use `-LiteralPath` for all constructed paths in exit cleanup to prevent wildcard interpretation (47-ExitCleanup).
+- **Cleanup:** Removed unused `$script:BITSPreferred` variable (00-Initialization).
+- 63 modules, 1853 tests
+
 ## v1.18.2
 
 - **Bug Fix:** HTML reports encode all dynamic values with `HtmlEncode` — VM names, adapter names, CPU model, process names, and config profile comparison data are now safe from display issues with special characters like `&`, `<`, `>` in generated HTML (54-HTMLReports).

Header.ps1

@@ -30,11 +30,23 @@
     7h3 4b1d3r
 
 .VERSION
-    1.18.2
+    1.19.0
 
 .LAST UPDATED
     03/04/2026
 
+.CHANGELOG v1.19.0
+    NAVIGATION + RESILIENCE SWEEP — 20 FIXES:
+    - FIX: "Home" navigation now works from all nested menus — added ReturnToMainMenu checks to 17 menu loops across iSCSI, Firewall Templates, NTP, Disk Cleanup, BitLocker, ISO Download, Cluster Dashboard, VM Checkpoints, VM Export/Import, Network Diagnostics, Hyper-V Replica, Storage Backends, and Settings
+    - FIX: Disk space pre-checks no longer fail on UNC/network paths — VM Export, VM Checkpoints, and VM Deployment now guard against non-drive-letter paths (clusters with CSVs, SMB shares)
+    - FIX: Hardcoded slmgr.vbs paths replaced with $env:SystemRoot for non-standard Windows installations (Licensing)
+    - FIX: Defender threat count logged correctly when query fails — $threats initialized before try block to prevent false "Threats=1" in session log (Defender Exclusions)
+    - FIX: IPv6 disable now reports actual failures instead of silent success — changed from SilentlyContinue to Stop error action (IP Configuration)
+    - FIX: Export VM cleanup now properly stops orphaned background jobs before removing them (VM Export/Import)
+    - FIX: $Matches automatic variable captured immediately per project convention (NTP Configuration)
+    - FIX: Test-Path calls use -LiteralPath for all constructed paths in exit cleanup to prevent wildcard interpretation (Exit Cleanup)
+    - CLEANUP: Removed unused $script:BITSPreferred variable (Initialization)
+
 .CHANGELOG v1.18.2
     ROBUSTNESS + CONSISTENCY SWEEP — 14 FIXES:
     - FIX: HTML reports encode all dynamic values — VM names, adapter names, CPU model, process names, and config profile comparison data now use HtmlEncode to prevent display issues with special characters like & < > in generated HTML (54-HTMLReports)

Modules/00-Initialization.ps1

@@ -32,7 +32,6 @@ $script:FeatureInstallTimeoutSeconds = 1800  # 30 minutes max for Windows Featur
 $script:LargeFileDownloadTimeoutSeconds = 3600  # 1 hour for ISO/VHD downloads
 $script:DefaultDownloadTimeoutSeconds = 1800    # 30 minutes for standard downloads
 $script:MaxDownloadRetries = 3                      # Max retry attempts for large file downloads (>500MB)
-$script:BITSPreferred = $true                       # Use BITS transfer when available (supports native resume)
 # Configurable MSP agent installer (override via defaults.json AgentInstaller)
 $script:AgentInstaller = @{
     ToolName        = "MSP"
@@ -135,7 +134,7 @@ if (-not $script:ModuleRoot) { $script:ModuleRoot = $PSScriptRoot }
 if (-not $script:ModuleRoot -and $script:ScriptPath) {
     $script:ModuleRoot = [System.IO.Path]::GetDirectoryName($script:ScriptPath)
 }
-$script:ScriptVersion = "1.18.2"
+$script:ScriptVersion = "1.19.0"
 $script:ScriptStartTime = Get-Date
 
 # OS version detection (for feature compatibility)

Modules/07-IPConfiguration.ps1

@@ -444,7 +444,7 @@ function Disable-AllIPv6 {
 
     foreach ($adapter in $adapters) {
         try {
-            Disable-NetAdapterBinding -Name $adapter.Name -ComponentID ms_tcpip6 -ErrorAction SilentlyContinue
+            Disable-NetAdapterBinding -Name $adapter.Name -ComponentID ms_tcpip6 -ErrorAction Stop
             $successCount++
             Write-OutputColor "Disabled IPv6 on $($adapter.Name)" -color "Success"
         }

Modules/10-iSCSI.ps1

@@ -1246,6 +1246,7 @@ function Show-iSCSISANMenu {
 # Function to run iSCSI & SAN Management menu
 function Start-Show-iSCSISANMenu {
     while ($true) {
+        if ($global:ReturnToMainMenu) { return }
         $choice = Show-iSCSISANMenu
 
         $navResult = Test-NavigationCommand -UserInput $choice

Modules/17-DefenderExclusions.ps1

@@ -439,6 +439,7 @@ function Show-DefenderStatus {
     Write-OutputColor "" -color "Info"
 
     # Threat detection history
+    $threats = @()
     try {
         $threats = @(Get-MpThreatDetection -ErrorAction Stop)
         if ($threats.Count -gt 0) {

Modules/18-FirewallTemplates.ps1

@@ -2,6 +2,7 @@
 # Function to apply firewall rule templates
 function Set-FirewallRuleTemplates {
     while ($true) {
+        if ($global:ReturnToMainMenu) { return }
         Clear-Host
         Write-OutputColor "" -color "Info"
         Write-OutputColor "  ╔════════════════════════════════════════════════════════════════════════╗" -color "Info"

Modules/19-NTPConfiguration.ps1

@@ -2,6 +2,7 @@
 # Function to configure NTP time servers
 function Set-NTPConfiguration {
     while ($true) {
+        if ($global:ReturnToMainMenu) { return }
         Clear-Host
         Write-OutputColor "" -color "Info"
         Write-OutputColor "  ╔════════════════════════════════════════════════════════════════════════╗" -color "Info"
@@ -161,7 +162,8 @@ function Show-DetailedTimeStatus {
 
             # Parse phase offset (in seconds)
             if ($lineStr -match 'Phase Offset:\s*([\-\d\.]+)s') {
-                $offsetSeconds = [double]$Matches[1]
+                $regexMatches = $matches
+                $offsetSeconds = [double]$regexMatches[1]
             }
         }
     }

Modules/20-DiskCleanup.ps1

@@ -2,6 +2,7 @@
 # Function to run disk cleanup
 function Start-DiskCleanup {
     while ($true) {
+        if ($global:ReturnToMainMenu) { return }
         Clear-Host
         Write-OutputColor "" -color "Info"
         Write-OutputColor "  ╔════════════════════════════════════════════════════════════════════════╗" -color "Info"

Modules/21-Licensing.ps1

@@ -96,7 +96,7 @@ function Get-WindowsVersionInfo {
 # Function to check if server is activated
 function Test-ServerActivated {
     try {
-        $result = cscript.exe //NoLogo C:\Windows\System32\slmgr.vbs /dli 2>&1
+        $result = cscript.exe //NoLogo "$env:SystemRoot\System32\slmgr.vbs" /dli 2>&1
         $resultText = $result -join "`n"
 
         if ($resultText -match "License Status: Licensed") {
@@ -132,7 +132,7 @@ function Enable-ServerActivation {
         }
 
         Write-OutputColor "Installing product key..." -color "Info"
-        $ipkResult = cscript.exe //NoLogo C:\Windows\System32\slmgr.vbs /ipk "$productKey" 2>&1
+        $ipkResult = cscript.exe //NoLogo "$env:SystemRoot\System32\slmgr.vbs" /ipk "$productKey" 2>&1
         $ipkText = $ipkResult -join ' '
 
         if ($ipkText -notmatch "(?i)success") {
@@ -153,7 +153,7 @@ function Enable-ServerActivation {
 
         Write-OutputColor "  Key installed. Activating..." -color "Info"
         Start-Sleep -Seconds 5
-        $activateResult = cscript.exe //NoLogo C:\Windows\System32\slmgr.vbs /ato 2>&1
+        $activateResult = cscript.exe //NoLogo "$env:SystemRoot\System32\slmgr.vbs" /ato 2>&1
         $atoText = $activateResult -join ' '
 
         if ($atoText -match "(?i)success") {