PayloadKit

Software Update

com.apple.SoftwareUpdate

The payload that configures the software update policy. Removed: use the declarative management 'com.apple.configuration.softwareupdate.settings' configuration.

macOS 10.7+ · removed 27.0
Apple schemacombined

Not available with User Enrollment · Only one instance per profile · macOS: device channel only

Configuration Keys (12)

Showing 12 of 12 keys

KeyTypeDescriptionDefaultRange

Catalog URL

macOS 10.7+ · deprecated 11.0

deprecated
stringThe URL of the software update catalog. This property isn't supported in macOS 11 and later.Default: —Range: —

Disable Extended Validation check of TLS certificate.

booleanThis option was needed during Mojave betas which required https.Default: —Range: —

Automatically check for updates

macOS 10.15+

booleanIf 'false', deselects the "Check for updates" option and prevents the user from changing the option.Default: trueRange: —

Download newly available updates in the background

macOS 10.15+

booleanIf 'false', deselects the "Download new updates when available from the App Store" option and prevents the user from changing the option.Default: trueRange: —

Automatically install macOS updates

macOS 10.15+

booleanIf 'false', restricts the "Install macOS Updates" option and prevents the user from changing the option.Default: trueRange: —

Automatically install App Store app updates

macOS 10.15+

booleanIf 'false', deselects the "Install app updates from the App Store" option and prevents the user from changing the option.Default: trueRange: —

Install XProtect, MRT, & Gatekeeper updates automatically

macOS 10.15+

booleanIf 'false', restricts the automatic installation of configuration data.Default: trueRange: —

Install security updates automatically

macOS 10.15+

booleanIf 'false', disables the automatic installation of critical updates and prevents the user from changing the "Install system data files and security updates" option.Default: trueRange: —

Allow pre-release update installation

macOS 10.9+

booleanIf 'true', prerelease software can be installed on this computer.Default: trueRange: —

Force Update Delay

booleanSoftware updates will be delayed by the duration defined by ManagedDeferredInstallDelay.Default: —Range: —

Restrict app installations to admin users

macOS 10.14+

booleanIf 'true', restrict app installations to admin users. This key has the same function as the 'restrict-store-require-admin-to-install' key in the 'com.apple.appstore' payload.Default: falseRange: —

Update Delay

integerThe duration that software updates will be delayed.

Depends on: forceDelayedSoftwareUpdates ∈ [true]

Default: 30Range: —