#Requires -Version 5.1
<#
    JbTecWiz Support Centre -- generated fix script

    Fault : Wi-Fi disconnects every few minutes and reconnects
    Fix   : Calm the roaming and pin the band
    Source: https://jbtecwiz.com/support/win-net-wifi-drops

    Run as     : Device Manager, advanced driver properties
    Expect     : 15 minutes
    Risk       : low
    Reversible : yes

    WHEN THIS IS THE RIGHT FIX
    It drops when moving between access points, or at a desk that sits
    between two of them.

    HOW TO UNDO IT
    Every value above is a driver property; set it back to its default in
    the same dialog.

    This script walks the fix one step at a time and asks before each
    one. Steps with no command are things you do yourself -- it prints
    those and waits. Run with -DryRun to print without executing.

    --------------------------------------------------------------------
    NO WARRANTY - USE AT YOUR OWN RISK

    This script is provided by JbTecWiz as-is and with no warranty of any
    kind, express or implied. You run it entirely at your own risk.

    JbTecWiz accepts no liability for any loss or damage arising from its
    use, including but not limited to data loss, downtime, or configuration
    changes that turn out to be wrong for your system.

    You are responsible for reading this script before running it, for
    satisfying yourself that it suits the machine in front of you, and for
    having a working backup first. Some steps cannot be undone.
    --------------------------------------------------------------------
#>

[CmdletBinding()]
param(
    # Print every step and command without running anything.
    [switch]$DryRun,
    # Do not ask before each step. Read the script first if you use this.
    [switch]$Unattended
)

$ErrorActionPreference = 'Stop'
$script:Failed = 0

function Write-Rule { param([string]$Text)
    Write-Host ''
    Write-Host ('-' * 70) -ForegroundColor DarkGray
    if ($Text) { Write-Host $Text -ForegroundColor Cyan }
}

function Show-Prose { param([string]$Text, [string]$Colour = "Gray")
    if (-not $Text) { return }
    $words = $Text -split "\s+"; $line = "  "
    foreach ($w in $words) {
        if (($line.Length + $w.Length) -gt 74) { Write-Host $line -ForegroundColor $Colour; $line = "  " }
        $line += "$w "
    }
    if ($line.Trim()) { Write-Host $line -ForegroundColor $Colour }
}

function Invoke-Step {
    param(
        [int]$Number, [string]$Do, [string]$Why,
        [scriptblock]$Command, [switch]$Manual, [string]$Shell = "powershell"
    )
    Write-Rule "  Step $Number of 4"
    Show-Prose $Do "White"
    if ($Why) { Write-Host ""; Show-Prose $Why "DarkGray" }

    if ($Manual) {
        Write-Host ''
        Write-Host '  -> Do this yourself, then press Enter to carry on.' -ForegroundColor Yellow
        if (-not $Unattended -and -not $DryRun) { [void](Read-Host) }
        return
    }

    Write-Host ''
    foreach ($l in ($Command.ToString().Trim() -split "`n")) {
        Write-Host ("    " + $l.Trim()) -ForegroundColor Green
    }
    Write-Host ''

    if ($DryRun) { Write-Host "  (dry run -- not executed)" -ForegroundColor DarkGray; return }
    if (-not $Unattended) {
        $a = Read-Host "  Run this step? [Y]es / [S]kip / [Q]uit"
        if ($a -match "^[Qq]") { Write-Host "  Stopped at your request."; exit 0 }
        if ($a -match "^[Ss]") { Write-Host "  Skipped." -ForegroundColor DarkGray; return }
    }
    try { & $Command }
    catch {
        $script:Failed++
        Write-Host ("  Step $Number failed: " + $_.Exception.Message) -ForegroundColor Red
        Show-Prose "The rest of the fix may depend on this. Read the write-up before carrying on." "Red"
        if (-not $Unattended) {
            $c = Read-Host "  Carry on anyway? [y/N]"
            if ($c -notmatch "^[Yy]") { exit 1 }
        }
    }
}

Write-Rule
Write-Host '  Wi-Fi disconnects every few minutes and reconnects' -ForegroundColor White
Write-Host '  Calm the roaming and pin the band' -ForegroundColor Cyan
Write-Host ''
Write-Host '  Risk: low   Reversible   15 minutes'
Write-Host ''
Show-Prose 'No warranty. Use at your own risk - JbTecWiz accepts no liability. Read it before you run it, and have a backup.' 'DarkYellow'
Write-Rule

if (-not $Unattended -and -not $DryRun) {
    $go = Read-Host '  Ready? [y/N]'
    if ($go -notmatch "^[Yy]") { Write-Host "  Nothing was changed."; exit 0 }
}

Invoke-Step -Number 1 -Do 'See which access point it is actually on, and how strong the signal is.' -Command {
    cmd.exe /c 'netsh wlan show interfaces'
}

Invoke-Step -Number 2 -Do 'In Device Manager -> adapter -> Advanced, set "Roaming Aggressiveness" (Intel) or "Roaming Sensitivity" to Medium-Low, and "Preferred Band" to 5GHz where the coverage supports it.' -Why 'A high roaming value makes the adapter jump to a marginally better access point mid-transfer, which drops every session it was holding. Most of these faults are a laptop bouncing between two APs it can see equally well.' -Manual

Invoke-Step -Number 3 -Do 'List the stored profiles and remove any duplicate for the same SSID.' -Command {
    cmd.exe /c 'netsh wlan show profiles & netsh wlan delete profile name="OldSSID"'
}

Invoke-Step -Number 4 -Do 'If two access points broadcast the same SSID on 2.4GHz with overlapping channels, fix the channel plan on the access points -- channels 1, 6 and 11 only.' -Manual

Write-Rule "  Confirm it worked"
Show-Prose 'netsh wlan show interfaces holds the same BSSID for a full working session while the machine sits still.' 'White'

Write-Rule
if ($script:Failed -gt 0) {
    Write-Host ("  Finished with " + $script:Failed + " failed step(s).") -ForegroundColor Yellow
    Show-Prose 'Read the full write-up at https://jbtecwiz.com/support/win-net-wifi-drops' 'Yellow'
} else {
    Write-Host '  Finished.' -ForegroundColor Green
}
Write-Host ''
Show-Prose 'To undo: Every value above is a driver property; set it back to its default in the same dialog.' 'DarkGray'
Write-Rule