New in version 2.0.
Parameter | Choices/Defaults | Comments |
---|---|---|
array_add
boolean
|
|
Add new elements to the array for a key which has an array as its value.
|
domain
string
|
Default: "NSGlobalDomain"
|
The domain is a domain name of the form
com.companyname.appname . |
host
string
added in 2.1 |
The host on which the preference should apply.
The special value
currentHost corresponds to the -currentHost switch of the defaults commandline tool. |
|
key
string
/ required
|
The key of the user preference.
|
|
path
string
|
Default: "/usr/bin:/usr/local/bin"
|
The path in which to search for
osx_defaults . |
state
string
|
|
The state of the user defaults.
If set to
list will query the given parameter specified by key . Returns 'null' is nothing found or mis-spelled.list added in version 2.8. |
type
string
|
|
The type of value to write.
|
value
raw
|
The value to write.
Only required when
state=present . |
- osx_defaults:
domain: com.apple.Safari
key: IncludeInternalDebugMenu
type: bool
value: true
state: present
- osx_defaults:
domain: NSGlobalDomain
key: AppleMeasurementUnits
type: string
value: Centimeters
state: present
- osx_defaults:
domain: com.apple.screensaver
host: currentHost
key: showClock
type: int
value: 1
- osx_defaults:
key: AppleMeasurementUnits
type: string
value: Centimeters
- osx_defaults:
key: AppleLanguages
type: array
value:
- en
- nl
- osx_defaults:
domain: com.geekchimp.macable
key: ExampleKeyToRemove
state: absent
Hint
If you notice any issues in this documentation you can edit this document to improve it.