Scheduled Install
The default super workflow prompts the user to install/restart or defer, or if there is no local user logged in, installs/restarts immediately. Alternately, the installation or restart of any super workflow can be scheduled for a specific date and time.
Only one scheduled installation workflow method can be enabled at a time. For computers with Apple silicon, saved local authentication or saved MDM authentication is required for scheduled installation workflows that target macOS updates or upgrades.
Automatically install/restart the workflow target a specified number of days after the workflow zero date.
Command option example:
--scheduled-install-days=7
Command option disable example:
--scheduled-install-days=X
Configuration Profile Example:
<key>ScheduledInstallDays</key>
<string>7</string>
When an administrator-defined scheduled installation workflow is active all other deferral and deadline features are disabled. As a default, the user will not be notified of the pending scheduled installation. However, you can specify scheduled installation reminders by configuring the --scheduled-install-reminder option documented later on this page.
Although it's not required, this option is specifically designed to work along with the --schedule-workflow-active option in order to specify a time of day for the scheduled installation.
The scheduled install restart notification
Automatically install/restart the workflow target at a specific date and time.
Command option example:
--scheduled-install-date=2024-10-02:10:15
Command option disable example:
--scheduled-install-date=X
Configuration Profile Example:
<key>ScheduledInstallDate</key>
<string>2024-10-02:10:15</string>
At a minimum, you must always specify "YYYY-MM-DD". Hours are represented by a 24-hour clock, and any non-specified hours or minutes are rounded to "00".
When an administrator-defined scheduled installation workflow is active all other deferral and deadline features are disabled. As a default, the user will not be notified of the pending scheduled installation. However, you can specify scheduled installation reminders by configuring the --scheduled-install-reminder option documented later on this page.
If you do not specify a time with this option, it's specifically designed to work along with the --schedule-workflow-active option in order to specify a time of day for the scheduled installation.
The scheduled install restart notification
Allow the end user to select a specific date and time to automatically install/restart the workflow target.
Command option example:
--scheduled-install-user-choice
Command option disable example:
--scheduled-install-user-choice-off
Configuration Profile Example:
<key>ScheduledInstallUserChoice</key>
<true/>
If deadline options are also specified, the user is not be allowed to select a scheduled install past the soonest deadline. However, once a user selected scheduled installation workflow is active all other deferral and deadline features are disabled.
When the user completes a scheduled install selection, they are immediately presented with the schedule install reminder dialog. You can specify additional scheduled installation reminders by configuring the --scheduled-install-reminder option documented later on this page.
Although it's not required, this option is specifically designed to work along with the --schedule-workflow-active option to automatically adjust any user-selected date and time so that it falls within a scheduled workflow active time frame.
The scheduled install button in an update dialog
The scheduled install user choice dialog
The scheduled install user choice with a deadline dialog
The scheduled install user choice reminder dialog
The scheduled install restart notification
Display reminder dialogs at specified minutes prior to the scheduled installation date and time.
Command option example:
--scheduled-install-reminder=120,60,5
Command option disable example:
--scheduled-install-reminder=X
Configuration Profile Example:
<key>ScheduledInstallReminder</key>
<string>120,60,5</string>
The time selections are specified with one or more number of minutes that are comma separated with no spaces. Times less than 2 minutes or more than 10080 minutes (1 week) are rounded accordingly.
This option requires that you have also specified at least one of the other scheduled installation options.
If the --scheduled-install-user-choice option is also specified then the scheduled install reminder dialog also shows a button allowing the user to reschedule their previously selected installation.
The scheduled install days/date reminder dialog
The scheduled install user choice reminder dialog
Remove all scheduled installation options.
Command option example:
--scheduled-install-delete-all
This option can not be set via a MDM configuration profile. However, any other deferral options that are specified via a super MDM configuration profile remain in effect.