-
Notifications
You must be signed in to change notification settings - Fork 0
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.
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.
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.
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.
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.
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.
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.
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.