community.general.xfconf_info 模块 – 获取 XFCE4 配置

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.xfconf_info。

community.general 3.5.0 中的新增功能

概要 

此模块允许借助 xfconf-query 获取 Xfce 4 配置。

参数 

参数	注释
channel 字符串	Xfconf 首选项通道是 Xfconf 存储库中对应于存储所有应用程序属性/键的位置的顶层树键。如果未提供，则该模块将列出所有可用的通道。
property 字符串	Xfce 首选项键是 Xfconf 存储库中对应于应用程序首选项的元素。如果提供了此选项，则需要 `channel`。如果未提供，并且提供了 `channel`，则该模块将列出该 `channel` 中所有可用的属性。

属性 

属性	支持	描述
check_mode	支持: 完整在 community.general 3.3.0 中添加此操作不修改状态。	可以在 `check_mode` 中运行，并返回更改状态预测，而无需修改目标。
diff_mode	支持: 不适用此操作不修改状态。	在 diff 模式下，将返回有关已更改的内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

注意 

注意

有关更多详细信息，请参阅 man 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"]`

作者

Alexei Znamensky (@russoz)