community.general.osx_defaults – Управление системными настройками macOS

Примечание

Этот плагин входит в сборку community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.osx_defaults.

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
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	Варианты: array bool boolean date float int integer string ←	Тип значения для записи.
value raw		Значение для записи. Требуется только при `state=present`.

Примечания

Примечание

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

Примеры

# TODO: Describe what happens in each example

- community.general.osx_defaults:
    domain: com.apple.Safari
    key: IncludeInternalDebugMenu
    type: bool
    value: true
    state: present

- community.general.osx_defaults:
    domain: NSGlobalDomain
    key: AppleMeasurementUnits
    type: string
    value: Centimeters
    state: present

- community.general.osx_defaults:
    domain: /Library/Preferences/com.apple.SoftwareUpdate
    key: AutomaticCheckEnabled
    type: int
    value: 1
  become: yes

- community.general.osx_defaults:
    domain: com.apple.screensaver
    host: currentHost
    key: showClock
    type: int
    value: 1

- community.general.osx_defaults:
    key: AppleMeasurementUnits
    type: string
    value: Centimeters

- community.general.osx_defaults:
    key: AppleLanguages
    type: array
    value:
      - en
      - nl

- community.general.osx_defaults:
    domain: com.geekchimp.macable
    key: ExampleKeyToRemove
    state: absent

Авторы

Franck Nijhof (!НЕИЗВЕСТНО)

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