Deferral Behavior - App-Auto-Patch/AAP3-Wiki GitHub Wiki

When using the deferral workflow, App Auto-Patch sets a "zero-date", which is the date the patching cadence has started, when the script first runs with deferrals enabled. That zero-date can also be set to a certain day of the week using PatchWeekStartDay. AAP will continue attempting to install patches until the user successfully completes patching. At that point, the Patching Completion Status is set to TRUE. This status only resets back to FALSE when the number of days set by DaysUntilReset have lapsed since the zero-date.

Days Until Reset

Defines the period in days after which AAP resets the patching status to FALSE.

Configuration profile example:
<key>DaysUntilReset</key>
<integer>7</integer>

Patch Week Start Day (Optional)

Specifies the day of the week to set the "zero-date" used in calculating days until reset (1=Monday, 2=Tuesday...7=Sunday). For example, setting PatchWeekStartDay=2 and DaysUntilReset=7 will reset patching status every week on Tuesday <key>PatchWeekStartDay</key>
<integer>2</integer>

Deferral Time Default

The number of minutes to defer until the next update workflow attempt if a user chooses not to install updates
Command option example:
--deferral-timer-default=1440

Command option disable example:
--deferral-timer-default=X

Configuration profile example:
<key>DeferralTimerDefault</key>
<string>1440</string>

Using this option overrides the default deferral time which is set to 1440 minutes (24 hours). Times less than 2 minutes or more than 10080 minutes (1 week) are rounded accordingly.

Setting this option also affects the focus deferral timer when any focus deadlines are enabled, but you have not specified the --deferral-timer-focus option. Further, setting this option also affects the error deferral time unless you specify the --deferral-timer-error`` option. Finally, this deferral timer is automatically selected if you also specify a dialog timeout option

Deferral Timer Menu

Display a deferral time pop-up menu in the install update dialog that allows the user to override the --deferral-timer-default timer.

Command option example:
--deferral-timer-menu=5,30,60,120

Command option disable example:
--deferral-timer-menu=X

Configuration profile example:
<key>DeferralTimerMenu</key>
<string>5,30,60,120</string>

The time selections are specified with one or more number of minutes that are coma separated with no spaces. Times less than 2 minutes or more than 10090 minutes (1 week) are rounded accordingly.

The first number in the list is the default selection for the menu, thus it's automatically selected if the user does not choose another time from the menu or you also specify a dialog timeout option.

Deferral Timer Focus

The number of minutes to defer automatically if the user has enabled Focus/Do Not Disturb or when a process has requested that the display not go to sleep (for example, during an active meeting).

Command option example:
--deferral-timer-focus=120

Command option disable example:
--deferral-timer-focus=X

Configuration profile example:
<key>DeferralTimerFocus</key>
<string>120</string>

With this option you must also specify the --deadline-count-focus option. Times less than 2 minutes or more than 10080 minutes (1 week) are rounded accordingly.

Deferral Timer Error

The number of minutes to defer if AAP detect an error in the workflow.

Command option example:
--deferral-timer-error=120

Command option disable example:
--deferral-timer-error=X

Configuration profile example:
<key>DeferralTimerError</key>
<string>120</string>

Deferral Timer Workflow Relaunch

The number of minutes to defer if no updates are available. Enabling this option results in AAP acting as a permanent agent that checks for updates on a regular basis.

Command option example:
--deferral-timer-workflow-relaunch=1440

Command option disable example:
--deferral-timer-workflow-relaunch=X

Configuration profile example:
<key>DeferralTimerWorkflowRelaunch</key>
<string>1440</string>

Reset All Deferral Timers

Reset all locally set deferral timer options to their default setting.

Command option example:
--deferral-timer-reset-all

This option can not be set via a MDM configuration profile. However, any other deferral options that are specified via an App Auto Patch MDM configuration profile remain in effect.