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

Примечание

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

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

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

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

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

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

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

Параметры

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

Атрибуты

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

Примечания

Примечание

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: Removing a key
  community.general.osx_defaults:
    domain: com.geekchimp.macable
    key: ExampleKeyToRemove
    state: absent

Авторы

Franck Nijhof

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

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