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
 }
}

Using Intel AMT Power Management @ Home

Thu, 16 Jul 2009 22:39:00 +0000

I write most of my blog posts at home in the evenings. Usually when I find a new tool I install these first within a virtual machine, this to not mess our family PC or my laptop I use for work. All Virtual Machines run on a HP dc7800 desktop which has Intel vPro support. This PC is installed down in the cellar. To avoid having to go down there to power on the PC I have created two batch files that allow me to power up and power down the machine remotely using the Intel AMT power management feature.

ToolTip – PowerPlan Switcher for Windows

Sun, 24 May 2009 17:08:48 +0000

Just came across this very nice utility called the Smart Power Plan Switcher for Windows. The utility allows you to configure the power scheme to be used based on the current power status. So once your system runs on battery it will automatically switch to the preferred power scheme.

the Software can be downloaded from the MSDN Code Gallery

Power-Management on Anything About IT

PowerShell Script Get-BatteryChargeStatus

Using Intel AMT Power Management @ Home

ToolTip – PowerPlan Switcher for Windows