salt.modules.mac_power

Module for editing power settings on macOS

New in version 2016.3.0.

salt.modules.mac_power.get_computer_sleep()

Display the amount of idle time until the computer sleeps.

Returns

A string representing the sleep settings for the computer

Return type

str

CLI Example:

salt '*' power.get_computer_sleep

salt.modules.mac_power.get_display_sleep()

Display the amount of idle time until the display sleeps.

Returns

A string representing the sleep settings for the displey

Return type

str

CLI Example:

salt '*' power.get_display_sleep

salt.modules.mac_power.get_harddisk_sleep()

Display the amount of idle time until the hard disk sleeps.

Returns

A string representing the sleep settings for the hard disk

Return type

str

CLI Example:

salt '*' power.get_harddisk_sleep

salt.modules.mac_power.get_restart_freeze()

Displays whether 'restart on freeze' is on or off if supported

Returns

A string value representing the "restart on freeze" settings

Return type

string

CLI Example:

salt '*' power.get_restart_freeze

salt.modules.mac_power.get_restart_power_failure()

Displays whether 'restart on power failure' is on or off if supported

Returns

A string value representing the "restart on power failure" settings

Return type

string

CLI Example:

salt '*' power.get_restart_power_failure

salt.modules.mac_power.get_sleep()

Displays the amount of idle time until the machine sleeps. Settings for Computer, Display, and Hard Disk are displayed.

Returns

A dictionary containing the sleep status for Computer, Display, and Hard Disk

Return type

dict

CLI Example:

salt '*' power.get_sleep

salt.modules.mac_power.get_sleep_on_power_button()

Displays whether 'allow power button to sleep computer' is on or off if supported

Returns

A string value representing the "allow power button to sleep computer" settings

Return type

string

CLI Example:

salt '*' power.get_sleep_on_power_button

salt.modules.mac_power.get_wake_on_modem()

Displays whether 'wake on modem' is on or off if supported

Returns

A string value representing the "wake on modem" settings

Return type

str

CLI Example:

salt '*' power.get_wake_on_modem

salt.modules.mac_power.get_wake_on_network()

Displays whether 'wake on network' is on or off if supported

Returns

A string value representing the "wake on network" settings

Return type

string

CLI Example:

salt '*' power.get_wake_on_network

salt.modules.mac_power.set_computer_sleep(minutes)

Set the amount of idle time until the computer sleeps. Pass "Never" of "Off" to never sleep.

Parameters

minutes -- Can be an integer between 1 and 180 or "Never" or "Off"

Ptype

int, str

Returns

True if successful, False if not

Return type

bool

CLI Example:

salt '*' power.set_computer_sleep 120
salt '*' power.set_computer_sleep off

salt.modules.mac_power.set_display_sleep(minutes)

Set the amount of idle time until the display sleeps. Pass "Never" of "Off" to never sleep.

Parameters

minutes -- Can be an integer between 1 and 180 or "Never" or "Off"

Ptype

int, str

Returns

True if successful, False if not

Return type

bool

CLI Example:

salt '*' power.set_display_sleep 120
salt '*' power.set_display_sleep off

salt.modules.mac_power.set_harddisk_sleep(minutes)

Set the amount of idle time until the harddisk sleeps. Pass "Never" of "Off" to never sleep.

Parameters

minutes -- Can be an integer between 1 and 180 or "Never" or "Off"

Ptype

int, str

Returns

True if successful, False if not

Return type

bool

CLI Example:

salt '*' power.set_harddisk_sleep 120
salt '*' power.set_harddisk_sleep off

salt.modules.mac_power.set_restart_freeze(enabled)

Specifies whether the server restarts automatically after a system freeze. This setting doesn't seem to be editable. The command completes successfully but the setting isn't actually updated. This is probably a macOS. The functions remains in case they ever fix the bug.

Parameters

enabled (bool) -- True to enable, False to disable. "On" and "Off" are also acceptable values. Additionally you can pass 1 and 0 to represent True and False respectively

Returns

True if successful, False if not

Return type

bool

CLI Example:

salt '*' power.set_restart_freeze True

salt.modules.mac_power.set_restart_power_failure(enabled)

Set whether or not the computer will automatically restart after a power failure.

Parameters

enabled (bool) -- True to enable, False to disable. "On" and "Off" are also acceptable values. Additionally you can pass 1 and 0 to represent True and False respectively

Returns

True if successful, False if not

Return type

bool

CLI Example:

salt '*' power.set_restart_power_failure True

salt.modules.mac_power.set_sleep(minutes)

Sets the amount of idle time until the machine sleeps. Sets the same value for Computer, Display, and Hard Disk. Pass "Never" or "Off" for computers that should never sleep.

Parameters

minutes -- Can be an integer between 1 and 180 or "Never" or "Off"

Ptype

int, str

Returns

True if successful, False if not

Return type

bool

CLI Example:

salt '*' power.set_sleep 120
salt '*' power.set_sleep never

salt.modules.mac_power.set_sleep_on_power_button(enabled)

Set whether or not the power button can sleep the computer.

Parameters

enabled (bool) -- True to enable, False to disable. "On" and "Off" are also acceptable values. Additionally you can pass 1 and 0 to represent True and False respectively

Returns

True if successful, False if not

Return type

bool

CLI Example:

salt '*' power.set_sleep_on_power_button True

salt.modules.mac_power.set_wake_on_modem(enabled)

Set whether or not the computer will wake from sleep when modem activity is detected.

Parameters

enabled (bool) -- True to enable, False to disable. "On" and "Off" are also acceptable values. Additionally you can pass 1 and 0 to represent True and False respectively

Returns

True if successful, False if not

Return type

bool

CLI Example:

salt '*' power.set_wake_on_modem True

salt.modules.mac_power.set_wake_on_network(enabled)

Set whether or not the computer will wake from sleep when network activity is detected.

Parameters

enabled (bool) -- True to enable, False to disable. "On" and "Off" are also acceptable values. Additionally you can pass 1 and 0 to represent True and False respectively

Returns

True if successful, False if not

Return type

bool

CLI Example:

salt '*' power.set_wake_on_network True

© 2021 SaltStack.
Licensed under the Apache License, Version 2.0.
https://docs.saltproject.io/en/latest/ref/modules/all/salt.modules.mac_power.html