PowerShell Script Get-BatteryChargeStatus

Sun, 30 Jul 2017 15:05:03 +0000

Update 01.08.2017

*I have updated the script to ensure that the Windows.Devices.Power.Battery class is properly loaded, as this wasn’t the case in a PowerShell 64 bit session. *

A little script i wrote to retrieve the Battery Charge status. The script makes use of the BatteryReport class that agregates the information should the device have more than one battery like the Surface Book.

function Get-BatteryChargeStatus
{
<#
.Synopsis
 Get-BatteryChargeStatus
.DESCRIPTION
 Get-BatteryChargeStatus shows the Battery Charging status,
 the remaining Battery capacity in percent and if the system
 is running on Battery.

 The Battery Status can have one of the following values:
 Charging, Discharging, Idle or NotPresent
.PARAMETER Detail
 Displays additional Battery Information

.EXAMPLE
 Get-BatteryChargeStatus

Status Utilization PowerOnline
------ ----------- -----------
Charging 99 True

.EXAMPLE
 Get-BatteryChargeStatus -Detail

ChargeRateInMilliwatts : 3052
DesignCapacityInMilliwattHours : 68902
FullChargeCapacityInMilliwattHours : 70222
RemainingCapacityInMilliwattHours : 69689
Status : Charging
Utilization : 99
PowerOnline : True

.NOTES
 30/07/2017, Initial version, Alex Verboon
 01/08/2017, added class init to check that Windows.Device class is available. 
 
 For more information see: 
 https://docs.microsoft.com/en-us/uwp/api/windows.devices.power.batteryreport
 
#>
 [CmdletBinding()]
 Param
 (
 [switch]$Detail
 )

 Begin
 {
 Try{
 # First ensure Windows.Devices class is available 
 $BattAssembly = [Windows.Devices.Power.Battery,Windows.Devices.Power.Battery,ContentType=WindowsRuntime] 
 #[Windows.Devices.Power.Battery].Assembly
 }
 Catch
 {
 Write-Error "Unable to load the Windows.Devices.Power.Battery class"
 }
 
 Try{
 $Report = [Windows.Devices.Power.Battery]::AggregateBattery.GetReport() 
 }
 Catch{
 Write-Error "Unable to retrieve Battery Report information"
 Break
 }

 If ($Report.Status -ne "NotPresent")
 {
 $pbmax = [convert]::ToDouble($Report.FullChargeCapacityInMilliwattHours)
 $pbvalue = [convert]::ToDouble($Report.RemainingCapacityInMilliwattHours)
 $Utilization = [int][math]::Round( (($pbvalue / $pbmax) *100))
 $PowerOnlineStatus = (Get-CimInstance -ClassName batterystatus -Namespace root/WMI).PowerOnline

 # Check if at least one battery reports running on power
 If ($PowerOnlineStatus -contains "True")
 {
 $PowerOnline = $true
 }
 Else
 {
 $PowerOnline = $false
 }
 }
 Else
 {
 [int]$Utilization = 0
 $PowerOnline = ""
 }
 }

 Process
 {
 If ($Detail -eq $true)
 {
 $Properties = [ordered] @{
 ChargeRateInMilliwatts = $Report.ChargeRateInMilliwatts
 DesignCapacityInMilliwattHours = $report.DesignCapacityInMilliwattHours
 FullChargeCapacityInMilliwattHours = $Report.FullChargeCapacityInMilliwattHours
 RemainingCapacityInMilliwattHours = $Report.RemainingCapacityInMilliwattHours
 Status = $Report.Status
 Utilization = $Utilization
 PowerOnline = $PowerOnline
 }
 $BatteryChargeStatus = (New-Object -TypeName PSObject -Property $Properties)
 }
 Elseif ($Detail -eq $false)
 {
 $Properties = [ordered] @{
 Status = $Report.Status
 Utilization = $Utilization
 PowerOnline = $PowerOnline
 }
 $BatteryChargeStatus = (New-Object -TypeName PSObject -Property $Properties)
 }
 }
 End
 {
 $BatteryChargeStatus
 }
}

Engineering Windows 7 still alive - Windows 7 Battery Notification Messages

Mon, 08 Feb 2010 23:01:54 +0000

After months of silence (last post was on August 10, 2009) a new blog post was added on the Engineering Windows 7 blog. Looks like there is something to say about Batteries. Read the full story about “Windows 7 Battery Notification Messages” here

Related articles:
ToolTip: Power Plan Assistant for Windows 7

No Battery Alarm Sound on Vista - it's by design

Sat, 13 Dec 2008 21:48:25 +0000

Early this year I bought a new laptop for my wife with Windows Vista Home Premium pre-installed, before she used a notebook with Windows XP. Since she is using that new notebook, she is regularly complaining about Windows Vista just shutting down. Of course we could argue that people should read the messages they get such as the one below:

If Windows Vista would play a sound, people would probably pay more attention to it, but according to a Microsoft Knowledge base article KB950161. low and critical battery alarms do not sound on Windows Vista.

Battery on Anything About IT

PowerShell Script Get-BatteryChargeStatus

Engineering Windows 7 still alive - Windows 7 Battery Notification Messages

No Battery Alarm Sound on Vista - it's by design