Skip to main content

Get-LastRebootTime

Description​

Alerts if a device (workstation or server) hasn't been rebooted within a configurable number of days (and optionally minutes). Designed for RMM automation to proactively flag devices that have exceeded their expected reboot cycle.

Requirements​

  • Windows with PowerShell 5.1 or later
  • Internet access on first run (to install or update the Strapper module from PSGallery)

Usage​

If no parameters are provided, the script uses a default threshold of 8 days and alerts (exit code 1) if the device has not rebooted within that window.

Use default 8-day threshold​

.\Get-LastRebootTime.ps1

Set a custom day threshold​

.\Get-LastRebootTime.ps1 -ThresholdDays 14

Test with a short minute-based threshold​

.\Get-LastRebootTime.ps1 -ThresholdMinutes 30

Combine days and minutes​

.\Get-LastRebootTime.ps1 -ThresholdDays 7 -ThresholdMinutes 720

Parameters​

ParameterAliasRequiredDefaultTypeDescription
ThresholdDaysFalse8IntNumber of days since last reboot before alerting. Defaults to 0 when only -ThresholdMinutes is specified.
ThresholdMinutesFalse0IntNumber of minutes to use as the threshold (or to add to -ThresholdDays when both are specified).

-ThresholdDays and -ThresholdMinutes can be used independently or together:

  • If neither is specified, the default threshold is 8 days.
  • If only -ThresholdDays is specified, that value is the threshold.
  • If only -ThresholdMinutes is specified, -ThresholdDays is automatically set to 0 so the threshold is based solely on minutes.
  • If both are specified, their values are combined into a single threshold.

Output​

Exit CodeMeaning
0Device is within the reboot threshold
1Device has exceeded the reboot threshold (alert condition)

Log files are written to the script directory and are overwritten on each run so only the most recent execution is stored:

Get-LastRebootTime-log.txt
Get-LastRebootTime-error.txt

Each run logs:

  • Device name
  • Last reboot timestamp
  • Current uptime (days, hours, minutes)
  • Configured threshold
  • Result (OK with time remaining, or ALERT with uptime details)

If the last boot time cannot be retrieved, the script logs an error and exits with code 1.

Changelog​

2026-06-29​

  • Initial version of the document