Skip to content

RequiredArguments

BigMac Admin edited this page Dec 18, 2022 · 9 revisions

MaximumDeferrals

Type: <integer>

This is the maximum number of deferrals a user receives before Renew enters "Aggressive" mode. Please note that "Notifications" count toward the MaxmimumDeferrals amount even though the user does not interact with them.

Setting this to a value of -1 disables deferrals. Use this in combination with the Deadline optional argument or if you never want your user to get an Aggressive Mode message.

Recommended Value: 4

Minimum Value: -1

Maximum Value: 999

UptimeThreshold

Type: <integer>

The number of days which a device is online prior to the Renew experience starting. Devices were last powered on fewer than UptimeThreshold days will not receive notifications. Example: If a device is powered on October 1st, and the UptimeThreshold is set to 10 days, then the user will begin to be notified on October 11th.

Recommended Value: 10

Minimum Value: 0 can be used for testing

Maximum Value: 999

NotificationThreshold

Type: <integer>

The number of times the user will get a macOS Notification Center event prior to the full Swift Dialog experience. Example: If a device is is past the uptime threshold and not within a deferral timeframe, they will be first notified via a notification center event. Renew processes this as a deferral, and exits after sending the notification.

A value of -1 sets the Notification Threshold to infinite. Use this if you never want your user to get a Normal Mode dialog event. This is also supported to use in combination with the Deadline Optional Argument.

Note: This feature requires SwiftDialog 2.0 or greater.

Recommended Value: 2

Minimum Value: 0 to disable Notification Center events

Maximum Value: 999

DeferralDuration

Type: <integer>

The minimum number of hours between when a user is notified that they need to restart. This is clocked in calendar time, not device uptime. Example: A user receives a notification center event from Renew. If this value is set to 4, then the user will not receive another Renew event until that 4 hour duration has passed (regardless if the script runs again via LaunchAgent or otherwise).

Recommended Value: 4

Minimum Value: 0 can be used for testing

Maximum Value: 999