PayloadKit

Energy Saver

com.apple.MCX

The payload that configures Energy Saver settings.

macOS 10.7+
Apple schemacombined

Not available with User Enrollment · macOS: device channel only

Configuration Keys (23)

Showing 23 of 23 keys

KeyTypeDescriptionDefaultRange
string—Default: —Range: —

Desktop Energy Saver Settings

dictThe settings for a desktop computer.Default: —Range: —

Display Sleep Timer

integerThe display sleep time, in minutes. A value of 0 means never.Default: —Range: 0 – 180

System Sleep Timer

integerSystem sleep time, in minutes. A value of 0 means never.Default: —Range: 0 – 180

Disk(s) Sleep Timer

integerThe disk sleep time, in minutes. A value of 0 means never.Default: 10Range: 0 – 180

Wake on LAN

integerIf 'true', enables "Wake for network access."Default: —Range: 0, 1

Wake On Modem Ring

integerIf 'true', enables "Wake for modem ring."Default: —Range: 0, 1

Start up Automatically After a Power Failure

integerIf 'true', enables "Start up automatically after a power failure."Default: —Range: 0, 1

Dynamic Power Step

integerMay not be available on all systems.Default: —Range: 0, 1

Reduce Processor Speed

integerMay not be available on all systems.Default: —Range: 0, 1
string—Default: —Range: —

Portable Energy Saver Settings

dictThe settings for a laptop computer using battery power.Default: —Range: —

Display Sleep Timer

integerThe display sleep time, in minutes. A value of 0 means never.Default: —Range: 0 – 180

System Sleep Timer

integerSystem sleep time, in minutes. A value of 0 means never.Default: —Range: 0 – 180

Disk(s) Sleep Timer

integerThe disk sleep time, in minutes. A value of 0 means never.Default: 10Range: 0 – 180

Wake on LAN

integerIf 'true', enables "Wake for network access."Default: —Range: 0, 1

Wake On Modem Ring

integerIf 'true', enables "Wake for modem ring."Default: —Range: 0, 1

Start up Automatically After a Power Failure

integerIf 'true', enables "Start up automatically after a power failure."Default: —Range: 0, 1

Dynamic Power Step

integerMay not be available on all systems.Default: —Range: 0, 1

Reduce Processor Speed

integerMay not be available on all systems.Default: —Range: 0, 1

Portable Energy Saver Settings

dictThe settings for a laptop computer using AC power.Default: —Range: —

Display Sleep Timer

integerThe display sleep time, in minutes. A value of 0 means never.Default: —Range: 0 – 180

System Sleep Timer

integerSystem sleep time, in minutes. A value of 0 means never.Default: —Range: 0 – 180

Disk(s) Sleep Timer

integerThe disk sleep time, in minutes. A value of 0 means never.Default: 10Range: 0 – 180

Wake on LAN

integerIf 'true', enables "Wake for network access."Default: —Range: 0, 1

Wake On Modem Ring

integerIf 'true', enables "Wake for modem ring."Default: —Range: 0, 1

Start up Automatically After a Power Failure

integerIf 'true', enables "Start up automatically after a power failure."Default: —Range: 0, 1

Dynamic Power Step

integerMay not be available on all systems.Default: —Range: 0, 1

Reduce Processor Speed

integerMay not be available on all systems.Default: —Range: 0, 1
dictThe schedule for turning a computer on and off.Default: —Range: —

Start up or wake

dictThe schedule for turning the device on.Default: —Range: —
eventtypestring

Action

required
stringThe type of action defined by this schedule.Default: "wakepoweron"Range: Wake Up (wake), Power On (poweron), Wake Up/Power On (wakepoweron)
weekdaysinteger

Days to execute

required
integerOne or more days of the week in an unsigned integer bitmap: '1' = Mon '2' = Tue '4' = Wed '8' = Thu '16' = Fri '32' = Sat '64' = SunDefault: 31Range: —
weekdayinteger

Weekday

integer—Default: —Range: Monday (1), Tuesday (2), Wednesday (4), Thursday (8), Friday (16), Saturday (32), Sunday (64)
timeinteger

Time of day

required
integerThe time, in minutes, since midnight.Default: 0Range: —

Shut down, sleep or restart

dictThe schedule for turning the device off.Default: —Range: —
eventtypestring

Action

required
stringThe type of action defined by this schedule.Default: —Range: Sleep (sleep), Shut Down (shutdown), Restart (restart)
weekdaysinteger

Days to execute

required
integerOne or more days of the week in an unsigned integer bitmap: '1' = Mon '2' = Tue '4' = Wed '8' = Thu '16' = Fri '32' = Sat '64' = SunDefault: 31Range: —
weekdayinteger

Weekday

integer—Default: —Range: Monday (1), Tuesday (2), Wednesday (4), Thursday (8), Friday (16), Saturday (32), Sunday (64)
timeinteger

Time of day

required
integerThe time, in minutes, since midnight.Default: 0Range: —

Sleep Disabled

booleanIf 'true', disables sleep.Default: falseRange: —

Prevent Disabling FileVault

booleanIf 'true', the system won't disable FileVault.Default: falseRange: —

Prevent Enabling FileVault

booleanIf 'true', the system won't enable FileVault.Default: falseRange: —

Prevent Storing Temporary FileVault Key for Standby

macOS 10.10+

booleanIf 'true', the system won't store th FileVault key across restarts.Default: falseRange: —

Enable Guest Account

macOS 10.7+

booleanIf 'true', the system enables the guest account.Default: falseRange: —

Disable Guest Account

macOS 10.7+

booleanIf 'true', the system disables the guest account. This property has no effect if 'EnableGuestAccount' is 'true'.Default: falseRange: —

Ask for Secure Token Auth Bypass

booleanIf 'true', the system bypasses the secure token authorization dialog. This dialog only appears on APFS volumes.Default: falseRange: —

Cached Accounts Expiry

integerThe minimum number of seconds a mobile account can exist before the system makes an automatic attempt to remove the mobile account. Set to '0' to attempt removing it at the next login or logout. Set to '-1' to never attempt removing the mobile account.Default: -1Range: -1 – —

Allow Users to Stop Mobile Account Creation Prompts

booleanIf 'true', the system allows the user to stop the prompts about mobile account creation every time the user logs in. This key is only valid if 'com.apple.cachedaccounts.WarnOnCreate' is 'true'.Default: falseRange: —

Create Mobile Account at Login Time

booleanIf 'true', the system creates the mobile account at login time.Default: falseRange: —

Prompt for Mobile Account Creation

booleanIf 'true', the system asks the user whether to create the mobile account and it allows the user to not create it.Default: falseRange: —

Time Server

stringThe NTP server to connect to. In macOS 10.13 and later, only one time server is supported.Default: —Range: —
timeZonestring

Time Zone

stringThe time zone path location string in '/usr/share/zoneinfo/'; for example, 'America/Denver' or 'Zulu'.Default: —Range: —

Require Admin Credentials for Wi-Fi Power

macOS 10.9+

booleanIf 'true', requires administrator authorization to turn Wi-Fi on or off.Default: falseRange: —

Require Admin Credentials for Wi-Fi Network Change

macOS 10.9+

booleanIf 'true', requires administrator authorization for network changes.Default: falseRange: —

Require Admin Credentials for IBSS

macOS 10.9+

booleanIf 'true', requires administrator authorization to enable IBSS.Default: falseRange: —

Force Internet Sharing Off

booleanDisables Internet Sharing functionality on the device, preventing users from sharing their internet connection via Wi-Fi, Bluetooth, or USB.Default: falseRange: —