Nexthink Recognized by SIIA as the Best Digital Employee Experience Platform Learn more

Learn more

Learn more

cookie alert

We use cookies to offer you a better browsing experience, analyze site traffic, personalize content, and serve targeted advertisements. If you continue to use this site, you consent to our use of cookies.

Nexthink Library

Battery Status

Back

Battery Status

Latest Version: 4.3.1.0
|
Updated on April 12, 2024
Install

Description

Determine the health status of laptops' batteries in terms of capacity that they can still hold, identify which batteries need to be replaced and optimize the power settings of devices. Also change the power plan to optimize battery usage.

Versions

  • 4.3.1.0 - 12 Apr 2024 - Updated OS requirements
  • 4.3.0.0 - 22 Jul 2022 - Added compatibility for Apple M1 architecture on "Get Battery Status" Remote Action
  • 4.2.0.0 - 19 Apr 2022 - Added support for Windows 10 ARM devices on "Get Battery Status" Remote Action
  • 4.1.0.0 - 02 Dec 2021 - Added functionality on "Get Battery Status" Remote Action to retrieve the battery temperature
  • 4.0.1.0 - 27 Oct 2021 - Execution frequency and suggested scheduling updated on "Get Battery Status" and "Set Power Plan" Remote Actions
  • 4.0.0.0 - 23 Mar 2021 - Added macOS compatibility for the "Get Battery Status" Remote Action
  • 3.0.2.0 - 15 Jul 2020 - Updated "Get Battery Status" Remote Action
  • 3.0.1.0 - 08 May 2020 - Updated "Set Power Plan" Campaign to be compatible with previous Nexthink Finder versions
  • 3.0.0.0 - 17 Apr 2020 - Added "Get Multiple Batteries Status" Remote Action
  • 2.1.0.0 - 02 Apr 2020 - Updated "Get Battery Status" Remote Action
  • 2.0.0.0 - 23 Mar 2020 - Added "Set Power Plan" Remote Action
  • 1.3.0.0 - 17 Mar 2020 - Updated "Get Battery Status" Remote Action and documentation
  • 1.2.0.0 - 02 Mar 2020 - Updated "Get Battery Status" Remote Action
  • 1.1.0.0 - 20 Jun 2019 - Major refactoring and bugfixing of Get Battery Status Remote Action
  • 1.0.0.0 - Initial release

Content

Campaigns - 1
Remote actions - 3
Get Battery Status Get Multiple Batteries Status Set Power Plan

Required Products

Nexthink Act
Nexthink Engage

Platforms

Windows 7 or newer

Compatibility

V6.14 and later

This Might Interest You

Workflow: Windows 11 migration
New

Orchestrate the Windows 11 migration process with automated compatibility checks and pre-to-post migration user engagement.

Released on April 11, 2024
View Library Pack

Workflow: Device assignment verification
New

Orchestrate the verification and update of device assignee information in the ServiceNow Hardware Asset Management database through a dedicated workflow.

Released on April 10, 2024
View Library Pack

Get Battery Status

Script Description

Returns the health status of the battery installed on the laptop, in terms of capacity that it can still hold. It also retrieves for Windows devices the currently active power plan. Useful for identifying the batteries to be replaced and optimize the power settings of the devices.

Execution context and suggested scheduling

Run the script as 'local system'. The script should be executed every 1 day.

A timeout of 120 seconds is recommended.

Parameters

None.

Outputs

Label Type Description
Battery Health Ratio Health ratio, expressed as a percentage
Battery Designed Capacity Int Initial capacity, in milliamp per hour (mAh)
Battery Full Charge Capacity Int Current full charge capacity, in milliamp per hour (mAh)
Battery Cycle Count Int Number of charge cycles the battery has so far
Estimated Battery Life In Hours Float Estimated battery life time with one full charge in hours
Power Plan String The power plan which is currently active on the device. It will display "Custom" if the power plan is not any of the default ones (Balanced, High performance, Power saving) and it will display "Unknown" in the case the information could not be retrieved
Battery Serial Number String Serial number of the battery
Battery Condition String Battery condition (Normal or Service recommended)
Battery Temperature Float Battery temperature, measured in the unit that was chosen as input parameter (Celsius/Fahrenheit)
Prevent Automatic Sleeping When Display Off Bool Relates to macOS Sleep and Wake settings. If this output returns a True value then the setting 'Stop automatic sleeping when the display is off' is enabled
Put Hard Disks To Sleep Bool Relates to macOS Sleep and Wake settings. If this output returns a True value then the setting 'Put hard disks to sleep' is enabled
Power Nap Mode Bool Relates to macOS Sleep and Wake settings. If this output returns a True value then the setting 'Update your system while it's asleep' is enabled

Test Scenarios

OneBattery
Test Case Device has one battery
Environment Windows 7 Pro x86 (English), Windows 10 x64 (English)
Results Successful - The output fields show correct data
NoBattery
Test Case Device has no battery
Environment VM Windows 7 x86/x64 (Multi-language), VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Failure - The battery on this device cannot be detected
DevicePluggedIn
Test Case The device has a battery and is plugged in.
Environment macOS 10.14 EN
Results Success - The information is gathered except for the estimated battery life which is 0.
DeviceNotPluggedIn
Test Case The device has a battery and is drawing energy from it.
Environment macOS 10.14 EN
Results Success - The information is gathered including the estimated battery life.

Get Multiple Batteries Status

Script Description

Returns the health status of the batteries installed on the laptop, in terms of capacity that they can still hold. It also retrieves the currently active power plan. Useful for identifying the batteries to be replaced and optimize the power settings of the devices.

Execution context and suggested scheduling

Run the script as 'local system'. The script should be executed manually.

A timeout of 120 seconds is recommended.

Parameters

None.

Outputs

Label Type Description
Battery1 Health Ratio Health ratio for battery 1, expressed as a percentage
Battery1 Designed Capacity Int Initial capacity for battery 1, in milliamp hour (mAh)
Battery1 Full Charge Capacity Int Current full charge capacity for battery 1, in milliamp hour (mAh)
Battery1 Cycle Count Int Number of charge cycles the battery 1 has so far
Battery2 Health Ratio Health ratio for battery 2, expressed as a percentage
Battery2 Designed Capacity Int Initial capacity for battery 2, in milliamp hour (mAh)
Battery2 Full Charge Capacity Int Current full charge capacity for battery 2, in milliamp hour (mAh)
Battery2 Cycle Count Int Number of charge cycles the battery 2 has so far
Estimated Battery Life In Hours Float Estimated battery life time with one full charge in hours
Power Plan String The power plan which is currently active on the device. It will display "Custom" if the power plan is not any of the default ones (Balanced, High performance, Power saving) and it will display "Unknown" in the case the information could not be retrieved

Restrictions

Test Scenarios

OneBattery
Test Case Device has one battery
Environment Windows 7 Pro x86 (English), Windows 10 x64 (English)
Results Successful - The output fields show correct data
NoBattery
Test Case Device has no battery
Environment VM Windows 7 x86/x64 (Multi-language), VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Failure - The battery on this device cannot be detected

Set Power Plan

Script Description

Sets the device power plan (Balanced, High performance or Power saver) on Windows Configuration. By default the user will be asked before changing their current power plan.

Execution context and suggested scheduling

Run the script as 'local system'. The script should be executed every 1 day.

A timeout of 120 seconds is recommended.

Parameters

Label Description
Campaign Id ID of the campaign that ask the user if they want to change their plan. Use an empty ID to avoid asking the user and force the change
Power Plan To Set Power plan to set. Valid values are Balanced, High performance and Power saver

Outputs

None.

Restrictions

Test Scenarios

AcceptedCampaign
Test Case Device power plan is different than PowerPlanToSet.
The user accepts to change the power plan through the campaign.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - The power plan is correctly modified.
NoCampaign
Test Case Device power plan is different than PowerPlanToSet.
CampaignId is 00000000-0000-0000-0000-000000000000.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - The power plan is correctly modified.
RejectedCampaign
Test Case Device power plan is different than PowerPlanToSet.
The user rejects to change the power plan through the campaign.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - The power plan was not modified because the user rejected the campaign.
NoChangeNeeded
Test Case Device power plan is the same that PowerPlanToSet.
Environment VM Windows 7 x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - The recommended power plan was already configured.