Модуль community.general.osx_defaults – управление пользовательскими настройками macOS

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.osx_defaults.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры

Краткое описание

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

Параметры

Параметр	Комментарии
array_add логическое значение	Добавлять новые элементы в массив для ключа, значение которого является массивом. Варианты: `false` ← (по умолчанию) `true`
check_type логическое значение добавлено в community.general 8.6.0	Проверяет, соответствует ли тип заданного `value` типу существующей настройки. Если типы не совпадают, возникает ошибка. Варианты: `false` `true` ← (по умолчанию)
dict_mode строка добавлено в community.general 12.5.0	Определяет способ записи значений `type=dict`. `replace` записывает весь словарь, заменяя любое существующее значение. `add` объединяет с существующим словарём только указанные ключи, оставляя остальные ключи без изменений. Варианты: `"replace"` ← (по умолчанию) `"add"`
domain строка	Домен — это доменное имя формата `com.companyname.appname`. По умолчанию: `"NSGlobalDomain"`
host строка	Хост, для которого должна применяться настройка. Специальное значение `currentHost` соответствует параметру `-currentHost` инструмента командной строки defaults.
key строка	Ключ пользовательской настройки.
path строка	Путь, по которому следует искать `defaults`. По умолчанию: `"/usr/bin:/usr/local/bin"`
state строка	Состояние пользовательских настроек. Если задано значение `list`, выполняется запрос указанного параметра, заданного с помощью `key`. Возвращает `null`, если ничего не найдено или параметр написан с ошибкой. Варианты: `"absent"` `"list"` `"present"` ← (по умолчанию)
type строка	Тип записываемого значения. `dict` добавлено в community.general 12.5.0. Варианты: `"array"` `"bool"` `"boolean"` `"date"` `"dict"` `"float"` `"int"` `"integer"` `"string"` ← (по умолчанию)
value любое значение	Записываемое значение. Обязательно только при `state=present`.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз состояния изменений, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме diff возвращает подробную информацию об изменениях (или о том, что, возможно, нужно изменить в `check_mode`).

Примечания

Примечание

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

Примеры

- name: Set boolean valued key for application domain
  community.general.osx_defaults:
    domain: com.apple.Safari
    key: IncludeInternalDebugMenu
    type: bool
    value: true
    state: present

- name: Set string valued key for global domain
  community.general.osx_defaults:
    domain: NSGlobalDomain
    key: AppleMeasurementUnits
    type: string
    value: Centimeters
    state: present

- name: Set int valued key for arbitrary plist
  community.general.osx_defaults:
    domain: /Library/Preferences/com.apple.SoftwareUpdate
    key: AutomaticCheckEnabled
    type: int
    value: 1
  become: true

- name: Set int valued key only for the current host
  community.general.osx_defaults:
    domain: com.apple.screensaver
    host: currentHost
    key: showClock
    type: int
    value: 1

- name: Defaults to global domain and setting value
  community.general.osx_defaults:
    key: AppleMeasurementUnits
    type: string
    value: Centimeters

- name: Setting an array valued key
  community.general.osx_defaults:
    key: AppleLanguages
    type: array
    value:
      - en
      - nl

- name: Setting a dict valued key
  community.general.osx_defaults:
    domain: com.apple.finder
    key: FXInfoPanesExpanded
    type: dict
    value:
      General: true
      OpenWith: true
      Privileges: true

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

Авторы

Franck Nijhof

Ссылки на коллекцию

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