community.general.xfconf модуль — Редактирование конфигураций XFCE4

Примечание

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

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

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

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

Описание
Параметры
Атрибуты
См. также
Примеры
Возвращаемые значения

Описание

Этот модуль позволяет управлять конфигурацией Xfce 4 с помощью xfconf-query.

Параметры

Параметр	Комментарии
channel строка / обязательный	Канал настроек Xfconf — это ключевой элемент верхнего уровня в хранилище Xfconf, соответствующий расположению, в котором хранятся все свойства/ключи приложений. См. man xfconf-query(1).
force_array псевдонимы: массив булево добавлен в community.general 1.0.0	Принудительно задать массив, даже если есть только один элемент. Варианты: `false` ← (по умолчанию) `true`
property строка / обязательный	Ключ настроек Xfce — это элемент в хранилище Xfconf, соответствующий настройке приложения. См. man xfconf-query(1).
state строка	Действие, которое нужно выполнить со свойством/значением. Состояние `get` было удалено в community.general 5.0.0. Используйте модуль community.general.xfconf_info вместо него. Варианты: `"present"` ← (по умолчанию) `"absent"`
value список / элементы=любые	Свойства настроек обычно имеют простые значения, такие как строки, целые числа или списки строк и целых чисел. См. man xfconf-query(1).
value_type список / элементы=строка	Тип значения, которое задаётся. Если задается более одного `value_type`, длина списка должна быть равна длине `value`. Если задано только одно `value_type`, но `value` содержит более одного элемента, то `value_type` будет применено ко всем элементам `value`. Если задаваемое `property` — это массив, и он может содержать только один элемент в массиве, то необходимо использовать `force_array=true`, чтобы убедиться, что `xfconf-query` интерпретирует значение как массив, а не скаляр. Поддержка `uchar`, `char`, `uint64`, и `int64` добавлена в community.general 4.8.0. Варианты: `"string"` `"int"` `"double"` `"bool"` `"uint"` `"uchar"` `"char"` `"uint64"` `"int64"` `"float"`

Атрибуты

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

См. также

xfconf-query(1) man page: Руководство пользователя утилиты xfconf-query на сайте документации XFCE.
xfconf - Система хранения конфигураций: Документация XFCE по системе конфигураций Xfconf.

Примеры

---
- name: Change the DPI to "192"
  xfconf:
    channel: "xsettings"
    property: "/Xft/DPI"
    value_type: "int"
    value: "192"

- name: Set workspace names (4)
  xfconf:
    channel: xfwm4
    property: /general/workspace_names
    value_type: string
    value: ['Main', 'Work1', 'Work2', 'Tmp']

- name: Set workspace names (1)
  xfconf:
    channel: xfwm4
    property: /general/workspace_names
    value_type: string
    value: ['Main']
    force_array: true

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для этого модуля:

Ключ	Описание
канал строка	Канал, указанный в параметрах модуля Возвращаемое значение: успех Пример: `"xsettings"`
cmd список / элементы=строка добавлен в community.general 5.4.0	Список с результатом `xfconf-query` команды, выполненной модулем. Возвращаемое значение: успех Пример: `["/usr/bin/xfconf-query", "--channel", "xfce4-panel", "--property", "/plugins/plugin-19/timezone", "--create", "--type", "string", "--set", "Pacific/Auckland"]`
предыдущее_значение любой тип	Значение ключа настройки до выполнения модуля. Либо единственное строковое значение, либо список строк для массивов. Это строка или список строк. Возвращаемое значение: успех Пример: `"\"96\" or [\"red\", \"blue\", \"green\"]"`
свойство строка	Свойство, указанное в параметрах модуля Возвращаемое значение: успех Пример: `"/Xft/DPI"`
значение любой тип	Значение ключа настройки после выполнения модуля. Либо единственное строковое значение, либо список строк для массивов. Это строка или список строк. Возвращаемое значение: успех Пример: `"\"192\" or [\"orange\", \"yellow\", \"violet\"]"`
тип_значения любой тип	Тип значения, которое было изменено (`none` для `state=reset`). Либо единственное строковое значение, либо список строк для массивов. Это строка или список строк. Возвращаемое значение: успех Пример: `"\"int\" or [\"str\", \"str\", \"str\"]"`

Авторы

Joseph Benden (@jbenden)
Alexei Znamensky (@russoz)

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

© 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/xfconf_module.html