You are using an ad blocker that is interfering with our web typography and internal javascript. Please whitelist our domain to live in a more beautiful world. No ads here, just really great software!

Experience Everywhere On-Demand: Learn how Global 2000 firms are approaching Digital Employee Experience in 2021. Get Access

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

Hardware Asset Renewal Advanced

Latest Version: 1.0.0.0
Install
Configuration

Content

Campaigns - 2
Categories - 2
Dashboards - 5
Investigations - 1
Metrics - 41
Remote actions - 5
Get Disk Health Get Warranty Information Get Boot Details Set Boot Autologger Get Battery Status
Scores - 3

Required Products

Nexthink Act
Nexthink Engage

Platforms

Windows 10
Windows 7
macOS

Compatibility

V6.27 and later

Description

The Hardware asset renewal advanced pack helps you manage the life cycle of your devices. It is based on the Digital Experience (DEX) device score which measures the actual experience with your devices along with the hardware asset health score next to it.

Screenshots

Versions

  • 1.0.0.0 - 12 Nov 2020 - Initial release

Get Disk Health

Script Description

Gets physical disk health details where the drive is located (identified by a given drive letter).

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

Label Description
Drive Letter Drive letter which you want drive and disk information from. It must be a single letter from A to Z (English alphabet)
Disk Minimum Temperature Temperature (in Celsius degrees) from which the disk will be considered to be heating ("DiskHot" output)

Outputs

Label Type Description
Predictive Failure Support Bool Whether the disk supports Predictive Failure feature or not
SMART Status String The current SMART status of the disk. More information about the possible statuses can be found here ("Status" section)
Disk Temperature Int Current disk temperature (in Celsius degrees)
Disk Hot Bool Whether the disk is heating (current temperature higher than 'DiskMinimumTemperature' input parameter value)
Write Errors Corrected Int The number of disk errors that have been corrected
Write Errors Uncorrected Int Number of uncorrected disk errors
Write Errors Total Int Total number of disk errors

Test Scenarios

DiskHealthDataRetrieved
Test Case The remote action is run on a device having a physical drive connected
Environment Windows 10 x64 (English) (1909) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - The health information about the disk is retrieved
DiskHasHighTemperature
Test Case The disk has a temperature that is higher than the value provided as input parameter
Environment Windows 10 x64 (English) (1909) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Success - "DiskHot" output is "yes"
DriveLetterBelongsToNetworkDrive
Test Case The drive letter provided as input parameter does not belong to a physical local disk
Environment Windows 10 x64 (English) (1909) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Failure - The drive must be located in a physical local disk
DriveLetterIsInvalid
Test Case The drive letter provided as input parameter is not between A to Z (English alphabet)
Environment Windows 10 x64 (English) (1909) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Failure - The drive letter provided is invalid

Get Warranty Information

Script Description

Retrieves warranty information of Dell and/or Lenovo devices, via REST APIs.The warranty data obtained can be also related to the laptop batteries.

Execution context and suggested scheduling

Run the script as 'interactive user'. The script should be executed manually.

A timeout of 720 seconds is recommended.

Parameters

Label Description
Maximum Delay In Seconds Maximum delay in seconds to avoid overloading the vendor servers with too many API requests occuring at the same time
Dell Client ID Dell Client ID
Dell Client Secret Dell Client Secret token
Dell Device Warranty Product Codes Comma separated list of Dell's device warranty product codes to retrieve the information from
Dell Battery Warranty Product Codes Comma separated list of Dell's battery warranty product codes to retrieve the information from
Lenovo Client Token Lenovo Client token
Lenovo Device Warranty Product Codes Comma separated list of Lenovo's device warranty product codes to retrieve the information from
Lenovo Battery Warranty Product Codes Comma separated list of Lenovo's battery warranty product codes to retrieve the information from

Outputs

Label Type Description
Purchase Or Ship Date String Date when the device was purchased
Device Warranty End Date String Date when the device's warranty ends
Days Before Device Warranty Ends Int Number of days for the device's warranty expiration
Device Warranty Expired Bool If the device's warranty is expired or not
Battery Warranty End Date String Date when the battery's warranty ends
Days Before Battery Warranty Ends Int Number of days for the battery's warranty expiration
Battery Warranty Expired Bool If the battery's warranty is expired or not
Device Age In Years Int Number of years since the device purchase or ship date

Further Information

This Remote Action could fail in environments with a restricted network, due to the lack of communication with the corresponding vendor's API. The dates presented in the output fields are all in UTC time zone and with the following format":" Year/Month/Day Hours:minutes:seconds (24 hours).

Test Scenarios

SupportedVendorWarrantyDataRetrieved
Test Case The Supported Vendor API authentication data was provided
Environment Dell Windows 7 x86 (English) - Dell/Lenovo Windows 10 x64 (English) (1903)
Results Success - The warranty information for the target device is obtained from supported vendor's API
NoSupportedVendorProductCodesProvided
Test Case (Dell/Lenovo)DeviceWarrantyProductCodes and (Dell/Lenovo)BatteryWarrantyProductCodes input parameters are left empty ("")
Environment Dell Windows 7 x86 (English) - Dell/Lenovo Windows 10 x64 (English) (1903)
Results Success - The warranty end date for device and battery are exactly the same in the output
SupportedVendorAPINotReachable
Test Case The connection to the supported Vendor's API is not possible
Environment Dell Windows 7 x86 (English) - Dell/Lenovo Windows 10 x64 (English) (1903)
Results Failure - The warranty information cannot be obtained since there is a connection problem with the API
SupportedVendorAPIDataNotReliable
Test Case The data obtained from supported Vendor's API is not the expected one or there was a bad request (e.g. unauthorized Client ID)
Environment Dell Windows 7 x86 (English) - Dell/Lenovo Windows 10 x64 (English) (1903)
Results Failure - The warranty information cannot be obtained since there is a problem with the API request
UnsupportedDeviceVendor
Test Case The remote action is executed on a device that is not of a supported Vendor
Environment VM Windows 7 x86/x64 (Multi-language) - VM Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results Failure - The warranty information cannot be obtained since the device's manufacturer is not supported

Get Boot Details

Script Description

Provides detailed and granular information about the Boot time of a Windows 10 device.

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
Tracing Enabled String Indicates if the tracing has been enabled. The possibles values are (Tracing not enabled, Tracing is missing a provider, Tracing is enabled and data available, Tracing is enabled waiting for restart)
Boot Type String The type of the boot of the device. Values can be 'normal boot' or 'fast boot'
Last Boot Time DateTime Indicates the time when the last boot started
OS Boot Duration Millisecond Indicates the time from the moment the kernel is loaded until logonui.exe is started
Boot Duration Millisecond Indicates the time from the moment that the user presses the power button until the user credentials are entered
Main Path Boot Duration Millisecond Indicates the time from the moment that the OS starts to load until the desktop is displayed
Logon Duration Millisecond Indicates the time from the moment the user has entered the credentials until the is displayed

Further Information

Only compatible with Windows 10.

Test Scenarios

NormalBoot
Test Case Information gathered from a reboot (normal boot)
Environment VM & physical Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results SUCCESSFUL - All the information for normal boot gathered and correctly calculated
FastBoot
Test Case Information gathered from a turn off/on (fast boot)
Environment VM & physical Windows 10 x86/x64 (Multi-language) (1803/1809/1903)
Results SUCCESSFUL - All the information for fast boot gathered and correctly calculated

Set Boot Autologger

Script Description

Enables or disables an Autologger configuration on both Windows 10 and Windows 7. In addition to this, an ETW Trace Session will be enabled on Windows 10 along with the Autologger configuration.

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

Label Description
Status The action which the Remote Action will perform. The accepted values are 'enable' and 'disable'
Campaign Id The id of the Campaign which will be executed as the final step. Use an empty GUID (00000000-0000-0000-0000-000000000000) or empty value "" to avoid the Campaign

Outputs

None.

Further Information

It is necessary to restart the device after executing this Remote Action so that the Autologger can log boot details. In Windows 7, only after a reboot will the Autologger .etl file be removed.

Test Scenarios

EnableAutologgerWin10
Test Case The user chooses to enable an Autologger configuration.
Environment VM Windows 10 x64 (Multi-language) (1803/1809/1903)
Results Success - An Autologger configuration and a ETW Trace session are enabled.
DisableAutologgerWin10
Test Case The user chooses to disable an Autologger configuration.
Environment VM Windows 10 x64 (Multi-language) (1803/1809/1903)
Results Success - The Autologger configuration is disabled.
EnableAutologgerWin7
Test Case The user chooses to enable an Autologger configuration.
Environment VM Windows 7 x64 (Multi-language)
Results Success - An Autologger configuration is enabled.
DisableAutologgerWin7
Test Case The user chooses to disable an Autologger configuration.
Environment VM Windows 7 x64 (Multi-language)
Results Success - The Autologger configuration is disabled.
EnableAutologgerSessionIsActiveWin7
Test Case The user chooses to enable an Autologger configuration after having enabled it.
Environment VM Windows 7 x64 (Multi-language)
Results Failure - There is already an active Autologger session in the system.

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 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
Battery Health Ratio Health ratio, expressed as a percentage
Battery Designed Capacity Int Initial capacity, in milliamp hour (mAh)
Battery Full Charge Capacity Int Current full charge capacity, in milliamp hour (mAh)
Battery Cycle Count Int Number of charge cycles the battery has so far
Estimated Battery Life Millisecond Estimated battery life time with one full charge. It will be 0 on Windows 7 devices
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
Thank you!