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

Restart Device

Back

Restart Device

Latest Version: 1.5.4.0
|
Updated on April 17, 2024
Install
Configuration

Description

Retrieve information if device uptime is too long or pending reboot, launch campaign if needed and invoke restart. Can be configured as an on-demand restart.Possible causes for pending reboot:

   * Software installation.
   * Windows update.
   * File rename operations.
   * Domain join.
   * Computer renaming.
   * SCCM Agent.

Versions

  • 1.5.4.0 - 17 Apr 2024 - Updated OS requirements
  • 1.5.3.0 - 22 Jul 2022 - Enhanced documentation and fixed PATH vulnerability in RA "Restart-Device" v3.2.2.0
  • 1.5.2.0 - 19 Apr 2022 - Added the proper campaign to the content pack
  • 1.5.1.0 - 29 Nov 2021 - Added support of urgent campaigns for "Restart Device" Remote Action
  • 1.5.0.0 - 14 Apr 2021 - Updated "Restart Device" Remote Action description
  • 1.4.0.0 - 15 Jan 2021 - Fixed "Restart Device" Remote Action logic to evaluate pending restarts and modified input parameter name 'DeviceUptimeInDays' to 'NumberOfDaysSinceLastReboot'
  • 1.3.2.0 - 05 Nov 2020 - Fixed a problem with an input in "Restart Device" Remote Action
  • 1.3.1.0 - 30 Jul 2020 - Fixed a problem with date format in "Restart Device" Remote Action
  • 1.3.0.0 - 23 Mar 2020 - Updated "Restart Device" Remote Action
  • 1.2.0.0 - 11 Feb 2020 - Updated "Restart Device" Remote Action documentation
  • 1.1.0.0 - 07 Feb 2020 - Updated "Restart Device" Remote Action
  • 1.0.1.0 - 19 Dec 2019 - Fixed documentation
  • 1.0.0.0 - Initial release

Content

Campaigns - 1
Remote actions - 1
Restart Windows Device

Required Products

Nexthink Act
Nexthink Engage

Platforms

Windows 7 and 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

Restart Windows Device

Script Description

Retrieves information if restart is necessary due to too long device uptime or pending reboot, and based on provided input configures restart of target device. Campaign is displayed to enable user immediate restart, or postpone till next script execution. After restart, previously opened user's applications are restored.

Warning: The 'Device Restart' Remote Action restarts devices based on the provided input parameters. Avoid choosing parameters that cause users to be regularly prompted, or forced, to restart their device.

Execution context and suggested scheduling

Run the script as 'interactive user'. The script should be executed every 1 day.

A timeout of 720 seconds is recommended.

Parameters

Label Description
Number Of Days Since Last Reboot Number of days considered as maximum allowed without device restart. Accepted values are (0-60)
Test Pending Restart Test if a reboot is needed. Accepted values are (True/False)
Show Campaign Determines under what circumstances the campaign should be shown. Accepted values are (Always/DuringGracePeriod/OnlyFirstExecution/Never)
Campaign Id Id of a campaign to be presented to user before triggering restart
Postpone Grace Period In Days Number of days provided for user to postpone campaign, verified with hourly precision. Once due date is passed, restart will be scheduled. Accepted values are (1-30)
Restart Delay In Seconds Number of seconds provided as delay before restart is executed. Accepted values are (45-86400)
Campaign Timeout Number of seconds provided before the campaign times out. Accepted values are (60-600). This input will only be taken into account when ShowCampaign input is different from never

Outputs

None.

Further Information

For a deeper understanding of the usage of this Remote Action, read the official Nexthink Documentation here.

ShowCampaign input parameter behaviour:

- Always - The campaign is always shown to the user, and the user can decide if he wants to restart the device (Yes, restart) or if he wants to postpone the campaign (Postpone).

- Never - The campaign is never shown to the user. The device is restarted using the "RestartDelayInSeconds" input parameter. For e.g., if "RestartDelayInSeconds" is set to 300, once the RA is triggered on the device, the device is will restart after 300 seconds.

- OnlyFirstExecution - The campaign is shown only one time to the user, and the user can decide if he wants to restart the device (Yes, restart), or if he wants to postpone the campaign (Postpone). If the user decides to postpone the campaign, and the RA gets triggered another time on the device, this latter will be restarted using the "RestartDelayInSeconds" input parameter.

- DuringGracePeriod - If we use this parameter, the RA is going to take into account the PostponeGracePeriodInDays. It means that if we use 7 days as PostponeGracePeriodInDays, the campaign is shown during 7 days to the user. If the user restarts the device in the meantime, the counter is reset and the campaign is not shown anymore. But if the user does not restart the device during the 7 days of grace period, the device will be restarted on the 8th day using the RestartDelayInSeconds input.

Clarification - Postpone button in the campaign does not postpone the restart. It only postpones the campaign i.e. the user could receive the campaign again if the configuration allows it, but the restart is not postponed.

Test Scenarios

PatchPendingInstallation
Test Case .NET Hotfix was just installed
Environment Win7 Pro (multiple languages), Win10 Enterprise 1803 various applications were opened
Results Campaign was displayed, restart notifications were displayed, after restart all applications were restored.
DeviceIsCompliant
Test Case Device recently restarted, no pending hot-fixes
Environment Win7 Pro (multiple languages), Win10 Enterprise 1803
Results Script reported restart was not needed.
DeviceUptimeIsTooLong
Test Case Device was not restarted for longer than provided threshold, no pending hot-fixes
Environment Win7 Pro (multiple languages), Win10 Enterprise 1803
Results Script was processed, restart notifications were displayed, after restart all applications were restored.