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

Новая версия с 2.0.

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
array_add boolean	Варианты: нет ← да	Добавить новые элементы в массив для ключа, значение которого является массивом.
domain строка	Значение по умолчанию: "NSGlobalDomain"	Домен — имя домена в формате `com.companyname.appname`.
host строка добавлен в 2.1		Хост, на котором должна применяться настройка. Специальное значение `currentHost` соответствует переключателю `-currentHost` инструмента командной строки defaults.
key строка / обязательный		Ключ пользовательской настройки.
path строка	Значение по умолчанию: "/usr/bin:/usr/local/bin"	Путь для поиска `osx_defaults`.
state строка	Варианты: отсутствует список наличие ←	Состояние пользовательских значений по умолчанию. Если установлено значение `list`, будет произведен запрос к указанному параметру, определенному в `key`. Возвращает 'null', если ничего не найдено или неправильно указано. `list` добавлено в версии 2.8.
type строка	Варианты: массив bool boolean дата float int integer строка ←	Тип значения для записи.
value сырой		Значение для записи. Требуется только при `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: 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.8/modules/osx_defaults_module.html