Модуль community.general.xfconf_info — получение конфигураций XFCE4

Примечание

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

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

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

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

Добавлено в community.general 3.5.0

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

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

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

Параметры

Параметр	Комментарии
channel строка	Канал настроек Xfconf — это ключ дерева верхнего уровня в хранилище Xfconf, соответствующий расположению, в котором хранятся все свойства/ключи приложений. Если параметр не указан, модуль выводит список всех доступных каналов.
property строка	Ключ настроек Xfce — это элемент в хранилище Xfconf, соответствующий настройке приложения. Если параметр указан, требуется `channel`. Если параметр не указан, но задан `channel`, модуль выводит список всех доступных свойств в этом `channel`.

Параметр

Комментарии

channel

строка

Канал настроек Xfconf — это ключ дерева верхнего уровня в хранилище Xfconf, соответствующий расположению, в котором хранятся все свойства/ключи приложений.

Если параметр не указан, модуль выводит список всех доступных каналов.

property

строка

Ключ настроек Xfce — это элемент в хранилище Xfconf, соответствующий настройке приложения.

Если параметр указан, требуется channel.

Если параметр не указан, но задан channel, модуль выводит список всех доступных свойств в этом channel.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная добавлено в community.general 3.3.0 Это действие не изменяет состояние.	Может работать в `check_mode` и возвращать прогноз изменения состояния, не изменяя целевую систему.
diff_mode	Поддержка: Н/Д Это действие не изменяет состояние.	В режиме различий возвращает сведения об изменениях (или возможных изменениях в `check_mode`).

Примечания

Примечание

Дополнительные сведения см. в справочной странице xfconf-query(1).

Примеры

- name: Get list of all available channels
  community.general.xfconf_info: {}
  register: result

- name: Get list of all properties in a specific channel
  community.general.xfconf_info:
    channel: xsettings
  register: result

- name: Retrieve the DPI value
  community.general.xfconf_info:
    channel: xsettings
    property: /Xft/DPI
  register: result

- name: Get workspace names (4)
  community.general.xfconf_info:
    channel: xfwm4
    property: /general/workspace_names
  register: result

Возвращаемые значения

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

Ключ	Описание
channels список / элементы=строка	Список доступных каналов. Возвращается, если модулю не передан ни один параметр. Возвращается: при успехе Пример: `["xfce4-desktop", "displays", "xsettings", "xfwm4"]`
is_array логическое значение	Флаг, указывающий, является ли свойство массивом. Возвращается: при успехе
properties список / элементы=строка	Список доступных свойств для указанного канала. Возвращается, если модулю передан только параметр `channel`. Возвращается: при успехе Пример: `["/Gdk/WindowScalingFactor", "/Gtk/ButtonImages", "/Gtk/CursorThemeSize", "/Gtk/DecorationLayout", "/Gtk/FontName", "/Gtk/MenuImages", "/Gtk/MonospaceFontName", "/Net/DoubleClickTime", "/Net/IconThemeName", "/Net/ThemeName", "/Xft/Antialias", "/Xft/Hinting", "/Xft/HintStyle", "/Xft/RGBA"]`
value строка	Значение свойства. Пусто, если свойство имеет тип массива. Возвращается: при успехе Пример: `"Monospace 10"`
value_array список / элементы=строка	Значение свойства-массива. Пусто, если свойство не имеет тип массива. Возвращается: при успехе Пример: `["Main", "Work", "Tmp"]`
version строка добавлено в community.general 10.2.0	Версия команды `xfconf-query`. Возвращается: при успехе Пример: `"4.18.1"`

Авторы

Alexei Znamensky (@russoz)

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

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