Legacy Custom Settings (MCX)

This payload is the old, MCX style way to apply custom settings. It respects some of the semantics of Set-Once from the OS X 10.6 era.

This is a catch-all payload for writing defaults in any given preference domain. It is the macOS equivalent of iOS Defaults.

Summary

PayloadType:com.apple.ManagedClient.preferences
Supervised Only:
 N/A
macOS:N/A
macOS Deprecated:
 N/A
iOS:N/A
iOS Deprecated:N/A
Highlander:N/A

Keys

PayloadContent

Payload Content

An array of PayloadContent describing individual preferences

Type Default Required Regex iOS macOS Supervised
dict N/A N/A N/A N/A N/A N/A

PayloadContent Keys

Name Type Title Description Required
Forced array Forced Forced, which corresponds to the old MCX ‘Always’ setting. The setting is always managed n/a
Set-Once array Set Once Set Once, which corresponds to the old MCX ‘Often’ or ‘Once’ setting. The setting is once or sometimes managed. ‘Often’ has been deprecated. n/a

Forced

Forced is an array containing a dictionary in the following format:

Name Type Title Description Required
PayloadContent dict Payload Content An array of PayloadContent describing individual preferences n/a
key:PayloadContent:PreferenceDomainHere:Forced:ForcedItem