Contents

SoftwareUpdateSettings

The declaration to configure software updates.

Declaration

object SoftwareUpdateSettings

Properties

NameTypeDescription
AllowStandardUserOSUpdatesboolean

If set to true, a standard user can perform Major and Minor Software Updates.

If set to false, only administrators can perform Major and Minor Software Updates.

AutomaticActionsSoftwareUpdateSettingsAutomaticActionsObject

This object configures various automatic Software Update functionality.

BetaSoftwareUpdateSettingsBetaObject

This object configures the beta program settings for a device.

DeferralsSoftwareUpdateSettingsDeferralsObject

This object configures the deferral of software updates. Background Security Improvements aren’t considered in Major, Minor, or System deferral mechanism.

Notificationsboolean

If set to true, the device shows all software update enforcement notifications.

If set to false, the device only shows notifications triggered one hour before the enforcement deadline, and the restart countdown notification.

RapidSecurityResponseSoftwareUpdateSettingsRapidSecurityResponseObject

These configurations set user access to interacting with Background Security Improvement.

RecommendedCadencestring

This string specifies how the device shows software updates to the user. When more than one update is available update, the device behaves as follows:

  • All - Shows all software update versions.

  • Oldest - Shows only the oldest (lower numbered) software update version.

  • Newest - Shows only the newest (highest numbered) software update version.

Discussion

Specify com.apple.configuration.softwareupdate.settings as the declaration type.

Configuration availability

Allowed in supervised enrollment

iOS, macOS, Shared iPad, tvOS, visionOS

Allowed in device enrollment

iOS, Shared iPad, tvOS, visionOS

Allowed in user enrollment

NA

Allowed in local enrollment

NA

Allowed in system scope

iOS, macOS, Shared iPad, tvOS, visionOS

Allowed in user scope

NA

Configuration example

{
    "Type": "com.apple.configuration.softwareupdate.settings",
    "Identifier": "EB13EE2B-5D63-4EBA-810F-5B81D07F5017",
    "ServerToken": "E180CA9A-F089-4FA3-BBDF-94CC159C4AE8",
    "Payload": {
        "Notifications": false,
        "Deferrals": {
            "MajorPeriodInDays": 30
        },
        "RecommendedCadence": "All",
        "AutomaticActions": {
            "Download": "AlwaysOn",
            "InstallOSUpdates": "AlwaysOn",
            "InstallSecurityUpdate": "AlwaysOn"
        },
        "RapidSecurityResponse": {
            "Enable": false
        },
        "AllowStandardUserOSUpdates": false,
        "Beta": {
            "ProgramEnrollment": "AlwaysOn"
        }
    }
}

Topics

Objects

See Also

Configurations