Skip to content

Scheduled Install

Kevin edited this page Oct 2, 2024 · 1 revision

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.

Scheduled Install Days

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.

Scheduled Install Date

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.

Scheduled Install User Choice

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.

Scheduled Install Reminder Dialogs

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.

Delete All Scheduled Install Options

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.

Clone this wiki locally