# it-support-scripts

Abyres IT support diagnostic scripts. All scripts are **read-only** and make no changes to the device.

## laptop-check.ps1

This script checks a Windows laptop for performance, battery and throttling problems. It takes about 1 minute and includes a 30-second CPU load test.

### How to run
1. Press **Win + X**, choose **Terminal (Admin)**, then click **Yes**.
2. Paste and press Enter:
   ```
   [Net.ServicePointManager]::SecurityProtocol='Tls12'; irm https://git.abyres.net/kasyfur/it-support-scripts/raw/branch/main/laptop-check.ps1 | iex
   ```
3. Run it **twice**: once plugged in and once on battery. Close other apps first.

The script also saves `battery-report-<PC>-<time>.html` to the Desktop.

### What it checks
- Power source, charging status, power mode and CPU cap
- Battery health (current capacity vs design) and cycle count
- CPU load, top processes, and interrupt/DPC time
- 30-second full CPU load test, measuring clock speed under load
- Firmware throttling events, unexpected shutdowns with cause, and hardware errors (last 14 days)
- RAM, disk space and disk health

### Reading the result
Lines marked `[FLAG]` are issues, and they are listed again in the **SUMMARY** at the end.

| Finding | Likely cause |
|---|---|
| Load test under ~1,000 MHz | Battery/charger forcing throttling, or overheating |
| Battery under 60% of design | Battery worn, replace it |
| Battery draining while plugged in | Charger too weak or faulty |
| Sudden power loss shutdowns | Battery or adapter |
| One process with high CPU% | Software issue, not hardware |
| Power mode = Best power efficiency | Settings → System → Power & battery → change Power mode |

### Requirements
- Windows 10 or 11, run as Administrator
- Office network or VPN (to reach git.abyres.net)

### Options (for IT)
```
# Skip the load test
& ([scriptblock]::Create((irm https://git.abyres.net/kasyfur/it-support-scripts/raw/branch/main/laptop-check.ps1))) -NoLoad

# Longer load test (60 s)
& ([scriptblock]::Create((irm https://git.abyres.net/kasyfur/it-support-scripts/raw/branch/main/laptop-check.ps1))) -LoadSec 60
```

### Troubleshooting
| Problem | Fix |
|---|---|
| `irm` cannot connect | Connect to the office network or VPN |
| "Not run as Administrator" flag | Reopen with Win + X → Terminal (Admin) |
| Temperature not changing | The built-in sensor isn't live; use HWiNFO or Acer Care Center |

### Changelog
- **v2 (27 Oct 2026):** Battery health from battery report, CPU load test, shutdown cause, interrupt/DPC time, power mode via Windows API
- **v1 (27 Oct 2026):** Initial release

Reference (i3-1315U, TravelMate P214-55): about 2,400 MHz plugged in and about 1,600–1,900 MHz on battery under load is normal.