Restart Computer
Performs a controlled restart of the client as a standalone step in a workflow. The restart can be delayed, announced to the user, and limited to clients where a restart is actually pending.\n \nImportant: When the restart is started, the workflow stops here. Any brick placed after this brick is not executed, so place this brick last in the workflow.\n \nThe only exception is when “Only If Pending Reboot” is enabled and no restart is pending. Then nothing happens and the workflow continues with the next brick.
Parameters
Section titled “Parameters”Optional — Default: 60
The number of seconds to wait before the restart is started. Use it to give the user time to save their work. Example: 60\n \nThe message below is shown for the same number of seconds, so the user gets exactly the time the message announces.\n \nUse 0 to start the restart immediately. No message is shown then, because the user gets no time to read it. The value must be between 0 and 86400 seconds (24 hours).
Message
Section titled “Message”Optional — Default: Your computer will restart in a moment to finish a software installation. Please save your work.
The text shown to the user before the client restarts. It stays on screen for the number of seconds set in “Delay”, which is also how long the restart is postponed.\n \nThe message is only shown when a user is logged on and “Delay” is greater than 0. Leave it empty to restart without notifying the user.\n \nExample:\nYour computer will restart in a moment to finish a software installation. Please save your work.
Force Restart
Section titled “Force Restart”Optional — Default: False
Enable to restart the client even when a user is logged on.\n \nDisable to postpone the restart when a user is logged on - the workflow then ends with “Cancel retry later” and runs again at a later time. The restart is also postponed when it cannot be determined whether a user is logged on, so a client that may be in use is never restarted by mistake. The reason is written to the log.
Only If Pending Reboot
Section titled “Only If Pending Reboot”Optional — Default: False
Enable to restart the client only when Windows reports that a restart is pending, for example after a Windows update or a software installation that needs a restart to finish. When nothing is pending, the client is left running and the workflow continues with the next brick.\n \nDisable to always restart the client.
Details
Section titled “Details”- Category: System
- Brick ID:
Restart-Computer
{ "category": "system", "description": "Performs a controlled restart of the client as a standalone step in a workflow. The restart can be delayed, announced to the user, and limited to clients where a restart is actually pending.\\n \\nImportant: When the restart is started, the workflow stops here. Any brick placed after this brick is not executed, so place this brick last in the workflow.\\n \\nThe only exception is when \"Only If Pending Reboot\" is enabled and no restart is pending. Then nothing happens and the workflow continues with the next brick.", "developerVendor": "CapaSystems A/S", "displayName": null, "id": "Restart-Computer", "name": "Restart Computer", "parameters": [ { "allowManualInput": false, "defaultValue": "60", "defaultValueObject": null, "description": "The number of seconds to wait before the restart is started. Use it to give the user time to save their work. Example: 60\\n \\nThe message below is shown for the same number of seconds, so the user gets exactly the time the message announces.\\n \\nUse 0 to start the restart immediately. No message is shown then, because the user gets no time to read it. The value must be between 0 and 86400 seconds (24 hours).", "id": "Delay", "name": "Delay", "regExValidation": "", "required": false, "type": "Integer", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": "Your computer will restart in a moment to finish a software installation. Please save your work.", "defaultValueObject": null, "description": "The text shown to the user before the client restarts. It stays on screen for the number of seconds set in \"Delay\", which is also how long the restart is postponed.\\n \\nThe message is only shown when a user is logged on and \"Delay\" is greater than 0. Leave it empty to restart without notifying the user.\\n \\nExample:\\nYour computer will restart in a moment to finish a software installation. Please save your work.", "id": "Message", "name": "Message", "regExValidation": "", "required": false, "type": "TextBox", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": "False", "defaultValueObject": null, "description": "Enable to restart the client even when a user is logged on.\\n \\nDisable to postpone the restart when a user is logged on - the workflow then ends with \"Cancel retry later\" and runs again at a later time. The restart is also postponed when it cannot be determined whether a user is logged on, so a client that may be in use is never restarted by mistake. The reason is written to the log.", "id": "ForceRestart", "name": "Force Restart", "regExValidation": "", "required": false, "type": "Boolean", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": "False", "defaultValueObject": null, "description": "Enable to restart the client only when Windows reports that a restart is pending, for example after a Windows update or a software installation that needs a restart to finish. When nothing is pending, the client is left running and the workflow continues with the next brick.\\n \\nDisable to always restart the client.", "id": "OnlyIfPendingReboot", "name": "Only If Pending Reboot", "regExValidation": "", "required": false, "type": "Boolean", "value": null, "values": [], "valuesObject": null } ], "powershell": { "base64Encoded": true, "function": "ZnVuY3Rpb2..." }, "type": "powerbrick", "version": "2026.10.8.1"}