osx_defaults – Управление значениями по умолчанию macOS

Обзор
Параметры
Примечания
Примеры
Статус

Обзор

osx_defaults позволяет пользователям читать, записывать и удалять значения по умолчанию macOS из скриптов Ansible.
Приложения macOS и другие программы используют систему defaults для записи пользовательских предпочтений и другой информации, которая должна сохраняться при отсутствии работы приложений (например, шрифт по умолчанию для новых документов или положение панели «Информация»).

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
array_add boolean	Варианты: нет ← да	Добавить новые элементы в массив для ключа, значение которого является массивом.
domain string	Значение по умолчанию: "NSGlobalDomain"	Домен — имя домена в формате `com.companyname.appname`.
host string		Хост, на котором должны применяться настройки. Специальное значение `currentHost` соответствует переключателю `-currentHost` инструмента командной строки defaults.
key string / обязательно		Ключ пользовательской настройки.
path string	Значение по умолчанию: "/usr/bin:/usr/local/bin"	Путь для поиска `defaults`.
state string	Варианты: absent list present ←	Состояние пользовательских значений по умолчанию. Если установлено значение `list`, будет запрошен указанный параметр, определенный `key`. Возвращает 'null', если ничего не найдено или допущена опечатка. `list` добавлено в версии 2.8.
type string	Варианты: массив bool boolean дата float int integer строка ←	Тип значения для записи.
value raw		Значение для записи. Требуется только при `state=present`.

Примечания

Примечание

Кэш Apple Mac для значений по умолчанию. Возможно, потребуется выйти из системы и снова войти, чтобы изменения вступили в силу.

Примеры

- 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: /Library/Preferences/com.apple.SoftwareUpdate
    key: AutomaticCheckEnabled
    type: int
    value: 1
  become: yes

- 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

Статус

Для этого модуля гарантируются изменения интерфейса, совместимые с предыдущими версиями. [stableinterface]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Franck Nijhof (@frenck)

Подсказка

Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/osx_defaults_module.html