community.general.gconftool2 模块 – 编辑 GNOME 配置

注意

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

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

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

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

概要

  • 此模块允许通过 gconftool-2 操作 GNOME 2 配置。请参阅 gconftool-2(1) 手册页了解更多详细信息。

参数

参数

注释

config_source

字符串

指定要使用的配置源，而不是默认路径。

direct

布尔值

直接访问配置数据库，绕过服务器。如果指定了 direct，则还必须指定 config_source。

选项

  • false ← (默认)

  • true

key

字符串 / 必需

GConf 首选项键是 GConf 存储库中与应用程序首选项相对应的元素。

state

字符串 / 必需

对键/值执行的操作。

选项

  • "absent"

  • "present"

value

字符串

首选项键通常具有简单值，例如字符串、整数或字符串和整数列表。除非 state=present，否则将忽略此项。

value_type

字符串

设置的值的类型。除非 state=present，否则将忽略此项。

选项

  • "bool"

  • "float"

  • "int"

  • "string"

属性

属性

支持

描述

check_mode

支持：完全

可以在 check_mode 中运行并返回更改状态预测，而无需修改目标。

diff_mode

支持：无

当处于 diff 模式时，将返回有关已更改（或可能需要在 check_mode 中更改）的详细信息。

另请参阅

另请参阅

C(gconftool-2) 命令手册页

该命令的手册页。

示例

---
- name: Change the widget font to "Serif 12"
  community.general.gconftool2:
    key: "/desktop/gnome/interface/font_name"
    value_type: "string"
    value: "Serif 12"

返回值

通用返回值记录在此处，以下是此模块特有的字段

键

描述

key

字符串

模块参数中指定的键。

返回：成功

示例："/desktop/gnome/interface/font_name"

previous_value

字符串

执行模块之前首选项键的值。

从 community.general 7.0.0 版本开始，对于不存在的 key，它返回 null，之前返回 ""。

返回：成功

示例： "Serif 12"

value

字符串

执行模块后首选项键的值，如果键被删除则为 null。

从 community.general 7.0.0 版本开始，对于不存在的 key，它返回 null，之前返回 ""。

返回：成功

示例： "Serif 12"

value_type

字符串

更改的值的类型。

返回：成功

示例： "string"

版本

字符串

在 community.general 10.0.0 中添加

gconftool-2 的版本。

返回： 总是

示例： "3.2.6"

作者

  • Kenneth D. Evensen (@kevensen)