Reboot Pending Prompt - Detection [Windows]
Overview
This script serves as the detection logic for the Reboot Pending Prompt solution. Its primary function is to intelligently decide whether a reboot prompt should be displayed to the user.
It performs checks in three key areas:
- Operational Safety: Before evaluating necessity, the script checks if the Reboot Pending prompt - Autofix is currently active (specifically checking for the scheduled task it manages). If a prompt cycle is already in progress, this script exits immediately to prevent conflicting or duplicate actions.
- Necessity: It determines if a reboot is actually required by checking Windows Registry keys (for pending updates), comparing system uptime against a configured threshold, or checking for a manual administrator override.
- Timing & Convenience: If a reboot is needed, the script then validates if the current moment is appropriate for a prompt. It checks constraints such as "Quiet Hours" (suppress windows), weekend exclusions, user presence (logged in vs. lock screen), and ensures the user isn't prompted too frequently.
If the script determines a reboot is needed, the timing is valid, and no conflicting prompts are active, it returns an exit code that triggers the remediation script.
Install-In-Progress Protection
Before allowing any unattended reboot (no user logged in, or locked screen with the missed prompt threshold reached), the script checks whether the machine is currently installing software or updates. If it detects an active install, it skips the reboot and exits cleanly. The next time the script runs, it checks again. Once the install finishes, the reboot proceeds normally.
This prevents the machine from restarting in the middle of a Windows Update, application installer, or feature upgrade.
The script looks for the following signals:
| Signal | What It Means |
|---|---|
| TiWorker.exe | Windows Update is actively installing an update |
| wusa.exe | A standalone Windows Update package is being installed |
| SetupHost.exe | A Windows Feature Update is in progress |
| setup.exe | A general installer is running |
| MoUsoCoreWorker.exe | The Windows Update orchestrator is doing background work |
| Windows10Upgrader.exe | A feature upgrade using the Windows Update Agent is running |
| winget.exe (active) | Windows Package Manager is installing or updating software (only when actively using CPU) |
| MSI mutex held | An MSI installer package is currently running |
Note: This check only applies to unattended reboots. If a user is at their desk and clicks "Yes" to reboot, the reboot happens immediately regardless of background installs. The user made a conscious choice.
Sample Run
Note: This script is specifically engineered to operate as the detection condition within the Reboot Pending Prompt - Windows Workstation compound condition. Manual execution is not recommended, as the script's output is intended to trigger automated remediation actions rather than provide direct feedback.
Dependencies
- Custom Field: cPVAL Pending Reboot
- Custom Field: cPVAL Last Prompted
- Custom Field: cPVAL Times Prompted
- Custom Field: cPVAL Reboot Prompt When Pending Reboot
- Custom Field: cPVAL Reboot Prompt Uptime Days
- Custom Field: cPVAL Reboot Prompt Count
- Custom Field: cPVAL Reboot Prompt Duration Between Prompt
- Custom Field: cPVAL Reboot Prompt Skip Weekends
- Custom Field: cPVAL Reboot Prompt Suppress Time Window
- Custom Field: cPVAL Reboot if Not Logged In
- Custom Field: cPVAL Reboot During Suppress Period
- Custom Field: cPVAL Max Missed Prompts Before Force
- Custom Field: cPVAL Consecutive Missed Prompts
- Custom Field: cPVAL First Missed Prompt Time
- Solution: Reboot Pending Prompt
Custom Fields
| Custom Field | Type | Example | Scope | Available Options | Editable | Description |
|---|---|---|---|---|---|---|
| cPVAL Pending Reboot | Checkbox | True | Device | True, False | Yes | Manually forces a reboot prompt cycle on this specific device, regardless of Windows update status. |
| cPVAL Last Prompted | Text | 2024-05-20 14:30:00 | Device | N/A | No | Automatically records the date and time of the last reboot prompt shown to the user. |
| cPVAL Times Prompted | Numeric | 2 | Device | N/A | No | Automatically tracks how many times the user has been prompted (and deferred) for a reboot. |
| cPVAL Reboot Prompt When Pending Reboot | Dropdown | Enable | Organization, Location, Device | Enable, Disable | Yes | Enables or disables reboot prompts triggered specifically by Windows Registry pending reboot flags. |
| cPVAL Reboot Prompt Uptime Days | Numeric | 14 | Organization, Location, Device | N/A | Yes | Sets the maximum number of days a machine can run without a reboot before a prompt is triggered. Set to 0 to disable. |
| cPVAL Reboot Prompt Count | Numeric | 4 | Organization, Location, Device | N/A | Yes | Defines how many times a user can defer the reboot before it becomes mandatory. |
| cPVAL Reboot Prompt Duration Between Prompt | Numeric | 4 | Organization, Location, Device | N/A | Yes | Specifies the waiting period (in hours) between consecutive reboot prompts to avoid spamming the user. |
| cPVAL Reboot Prompt Skip Weekends | Dropdown | Enable | Organization, Location, Device | Enable, Disable | Yes | Prevents reboot prompts from appearing on Saturdays and Sundays. |
| cPVAL Reboot Prompt Suppress Time Window | Text | 1800-0800 | Organization, Location, Device | N/A | Yes | Defines a 24-hour time range (HHmm-HHmm) during which no prompts will be shown (e.g., overnight quiet hours). |
| cPVAL Reboot if Not Logged In | Dropdown | Enable | Organization, Location, Device | Enable, Disable | Yes | Allows the system to reboot immediately without showing a prompt if no user is currently signed in. |
| cPVAL Reboot During Suppress Period | Dropdown | Enable | Organization, Location, Device | Enable, Disable | Yes | Permits unattended or forced reboots to proceed even during configured suppress windows or weekends. |
| cPVAL Max Missed Prompts Before Force | Numeric | 3 | Organization, Location, Device | N/A | Yes | Sets the number of consecutive missed prompts (due to locked screen or no user) before forcing a reboot. Set to 0 to disable. |
| cPVAL Consecutive Missed Prompts | Numeric | 2 | Device | N/A | No | Automatically tracks how many prompt cycles were missed because the screen was locked or no user was signed in. |
| cPVAL First Missed Prompt Time | Text | 2024-05-20 14:30:00 | Device | N/A | No | Automatically records the exact date and time the current streak of missed prompts began. |
Configuration Hierarchy
The solution evaluates settings using a strict top-down hierarchy. If a value is configured at a higher priority level, it overrides the lower levels.
| Priority | Level | Description |
|---|---|---|
| 1 (Highest) | Device Level Custom Field | Overrides all lower levels. Applied to a specific endpoint. |
| 2 | Location Level Custom Field | Overrides Organization level. Applied to all endpoints in a location. |
| 3 | Organization Level Custom Field | Global default for the entire tenant. |
| 4 (Lowest) | Script Runtime Variable | Ultimate fallback default used if the custom field is blank at all levels. |
Script Variables
Instead of hardcoding defaults, the script relies on NinjaRMM Script Variables as the ultimate fallback mechanism. You can configure these variables directly in the script's settings within NinjaRMM to establish global baseline behaviors without modifying the code-signed script file.
| Name | Type | Example | Default | Available Options | Description |
|---|---|---|---|---|---|
Prompt Count | Integer | 5 | 4 | N/A | Max number of prompts allowed before the cycle resets. |
Duration Between Prompts | Integer | 6 | 4 | N/A | Minimum hours to wait between prompts. |
Suppress Time Window | String/Text | 1800-0800 | (blank) | N/A | 24h time range (HHmm-HHmm) to suppress prompts. |
Max Missed Prompts Before Force | Integer | 3 | 0 | N/A | Number of consecutive missed prompts before forcing a reboot. Set to 0 to disable. |
Reboot If Not Logged In | Dropdown | Enable | Disable | Disable, Enable | Enable to reboot immediately if no user is signed in. |
Skip Weekends | Dropdown | Enable | Disable | Disable, Enable | Enable to suppress prompts on Sat/Sun. |
Reboot During Suppress Period | Dropdown | Enable | Disable | Disable, Enable | Fallback default. Allows unattended machines to reboot during suppress windows or weekends if auto-reboot is enabled or the missed prompt threshold is reached. |
💡 Note: Do not attempt to change default values by editing the script file directly. The PowerShell script is code-signed, and modifying the code will break the signature and prevent execution. Always use Custom Fields or Script Variables to adjust behaviors.
Automation Setup/Import
Output
- Activity Details: Text output indicating if a reboot is required and if conditions were met.
- Custom Fields: Updates
cPVAL Pending Reboot,cPVAL Last Prompted,cPVAL Times Prompted,cPVAL Consecutive Missed Prompts, andcPVAL First Missed Prompt Timeas part of reset and missed-prompt tracking.
Changelog
2026-07-20
- Added the new custom field
cPVAL Reboot During Suppress Periodto allow unattended or forced reboots to proceed during configured suppress windows or weekends. - Converted hardcoded default values to NinjaRMM Script Variables, allowing administrators to define global fallback defaults directly within the script configuration UI.
- Removed the BITS transfer job check from the Install-In-Progress guard to prevent false positives from regular background downloads (e.g., browser downloads, non-critical updates).
2026-06-10
- Missed prompt counter now uses real elapsed time instead of counting each script run. This makes the forced reboot timeline predictable no matter how often the detection script checks in.
- Added safety checks for active installations before rebooting unattended machines. The script now looks for Windows Updates, feature upgrades, MSI installers, and winget activity.
- If a forced reboot is due but an install is still running, the reboot waits until the install finishes. It will trigger automatically on the next check after the install completes.
- Machines with no user logged in will no longer reboot mid-update. The script exits safely and retries on the next cycle once servicing is done.
- Winget (Windows Package Manager) is only treated as active when it is actually doing work, preventing false detections from an idle process.
- Script documentation updated to reflect all of the above changes.
2026-06-03
- Added support for missed-prompt tracking custom fields.
- Added default values for missed-prompt handling, weekend behavior, suppress window behavior, and no-user reboot behavior.
2026-05-26
- Added a default values region in the PowerShell script.
- Fixed a bug where the script was failing to reset the custom fields for manual reboot after rejecting the first prompt.
2026-03-23
- Updated .Net8 Desktop Runtime installation logic to install the latest available version.
- Code Signed the PowerShell script.
2025-12-19
- Initial version of the document