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

    Fault : Laptop throttles, runs hot, or shuts down under load
    Fix   : Clean the cooling path properly
    Source: https://jbtecwiz.com/support/win-hw-thermal

    Run as     : The machine, opened
    Expect     : 60-90 minutes
    Risk       : medium
    Reversible : yes

    WHEN THIS IS THE RIGHT FIX
    Any machine that has not been cleaned. This fixes the majority of them
    outright.

    HOW TO UNDO IT
    Not applicable.

    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 5"
    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 '  Laptop throttles, runs hot, or shuts down under load' -ForegroundColor White
Write-Host '  Clean the cooling path properly' -ForegroundColor Cyan
Write-Host ''
Write-Host '  Risk: medium   Reversible   60-90 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 'Confirm the diagnosis first so you are not opening it speculatively.' -Command {
    Get-WinEvent -LogName System -MaxEvents 300 | Where-Object Id -eq 86 | Format-Table TimeCreated,Message -Wrap
}

Invoke-Step -Number 2 -Do 'Read the temperatures under load with a vendor or third-party monitor. Sustained above 95C on the CPU package is throttling territory.' -Manual

Invoke-Step -Number 3 -Do 'Power down, disconnect the battery, and open the machine. Blow the dust out of the heatsink fins from the exhaust side, holding the fan still so it cannot be spun by the air.' -Why 'A fan spun by compressed air acts as a generator and can put a voltage back into the board. Holding the blade takes a second and removes the risk entirely.' -Manual

Invoke-Step -Number 4 -Do 'The blockage is usually a felt-like mat of dust between the fan and the fin stack, which is not visible from outside and does not clear by blowing into the vent from the outside.' -Manual

Invoke-Step -Number 5 -Do 'If the paste is several years old and the heatsink is off anyway, replace it.' -Manual

Write-Rule "  Confirm it worked"
Show-Prose 'Under the same load, the package temperature stays below its limit and event 86 stops appearing.' '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-hw-thermal' 'Yellow'
} else {
    Write-Host '  Finished.' -ForegroundColor Green
}
Write-Host ''
Show-Prose 'To undo: Not applicable.' 'DarkGray'
Write-Rule