Monitoring with PowerShell: Monitoring battery health

This one was requested by several users for a while, I added this to some script libraries but never actually released it on the blog so I figured it’s a good way to get back into blogging.

The monitor is pretty simple; first we run a command to check each battery in the system, we add this to an object. This object contains the reported information about the battery, How much charge it should have, according to the manufacturer, how much charge it’s actually holding, and where the battery came from and some identifying properties.

This script has been tested on a range of devices, but of course, some devices might fail at battery detection, or some just don’t report any number. If that’s the case, the script just writes this to the host without exiting.

The Script

Load this script up in your RMM for ease of execution, and have fun. 🙂

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27


$AlertPercent = "70"

& powercfg /batteryreport /XML /OUTPUT "batteryreport.xml"
Start-Sleep 1
[xml]$Report = Get-Content "batteryreport.xml"

$BatteryStatus = $Report.BatteryReport.Batteries |
ForEach-Object {
[PSCustomObject]@{
DesignCapacity = $_.Battery.DesignCapacity
FullChargeCapacity = $_.Battery.FullChargeCapacity
CycleCount = $_.Battery.CycleCount
Id = $_.Battery.id
}
}

if (!$BatteryStatus) {
Write-Host "This device does not have batteries, or we could not find the status of the batteries."
}

foreach ($Battery in $BatteryStatus) {
    if ([int64]$Battery.FullChargeCapacity \* 100 / [int64]$Battery.DesignCapacity -lt $AlertPercent) {
        Write-host "The battery health is less than expect. The battery was designed for $($battery.DesignCapacity) but the maximum charge is $($Battery.FullChargeCapacity). The battery info is $($Battery.id)"

    }

}

And as always, Happy PowerShelling 🙂