chocolatey.chocolatey.win_chocolatey_facts 模块 – 为 Chocolatey 创建事实集合

注意

此模块是 chocolatey.chocolatey 集合 (版本 1.5.3) 的一部分。

如果您使用的是 ansible 软件包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

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

要在剧本中使用它，请指定： chocolatey.chocolatey.win_chocolatey_facts。

chocolatey.chocolatey 0.2.8 中的新增功能

概要 

此模块显示来自 Chocolatey 的信息，例如已安装的软件包、过时的软件包、配置、功能和源。

参数 

参数	注释
filter 别名：gather_subset 列表 / 元素=字符串在 chocolatey.chocolatey 1.5.0 中添加	如果提供，则将收集到的事实限制为给定的子集。可能的值：`all`、`config`、`feature`、`outdated`、`packages`、`sources`。您可以提供一个值列表来指定更大的子集。选项 `"all"` ← (默认) `"config"` `"feature"` `"outdated"` `"packages"` `"sources"` 默认值： `["all"]`

备注 

注意

必须事先安装 Chocolatey，使用 chocolatey.chocolatey.win_chocolatey 来完成此操作。

另请参见 

另请参见

chocolatey.chocolatey.win_chocolatey: 使用 chocolatey 管理软件包。
chocolatey.chocolatey.win_chocolatey_config: 管理 Chocolatey 配置设置。
chocolatey.chocolatey.win_chocolatey_feature: 管理 Chocolatey 功能。
chocolatey.chocolatey.win_chocolatey_source: 管理 Chocolatey 源。

示例 

- name: Gather facts from chocolatey
  win_chocolatey_facts:

- name: Displays the Configuration
  debug:
    var: ansible_chocolatey.config

- name: Displays the Feature
  debug:
    var: ansible_chocolatey.feature

- name: Displays the Sources
  debug:
    var: ansible_chocolatey.sources

- name: Displays the Packages
  debug:
    var: ansible_chocolatey.packages

- name: Displays the Outdated packages
  debug:
    var: ansible_chocolatey.outdated

- name: Gather all facts from chocolatey, except outdated packages
  win_chocolatey_facts:
    filter:
    - 'config'
    - 'feature'
    - 'packages'
    - 'sources'

- name: Displays the collected facts from chocolatey without the outdated packages
  debug:
    var: ansible_chocolatey

- name: Clear existing facts from chocolatey
  ansible.builtin.meta: clear_facts

- name: Gather config and feature facts only from chocolatey
  win_chocolatey_facts:
    filter:
    - 'config'
    - 'feature'

- name: Displays the collected config and feature facts from chocolatey
  debug:
    var: ansible_chocolatey

返回的事实 

此模块返回的事实添加到/更新到 hostvars 主机事实中，并且可以像任何其他主机事实一样按名称引用。它们不需要注册即可使用。

键	描述
ansible_chocolatey 复杂类型	关于 Chocolatey 安装的详细信息返回：始终
config 字典	关于存储的配置的详细信息返回：始终（除非 filter 设置为排除 config）示例： `{"commandExecutionTimeoutSeconds": 2700, "containsLegacyPackageInstalls": true}`
feature 字典	关于已启用和已禁用功能的详细信息返回：始终（除非 filter 设置为排除 feature）示例： `{"allowEmptyCheckums": false, "autoUninstaller": true, "failOnAutoUninstaller": false}`
filter 列表 / 元素=字符串在 chocolatey.chocolatey 1.5.0 中添加	已收集的子集列表返回：始终示例： `["all"]`
outdated 复杂类型在 chocolatey.chocolatey 1.3.0 中添加	可更新的软件包列表返回：始终（除非 filter 设置为排除 outdated）
available_version 字符串	软件包的可用版本返回：始终示例： `"7.2.4"`
current_version 字符串	软件包的当前版本返回：始终示例： `"7.2.3"`
package 字符串	软件包的名称返回：始终示例： `"vscodepowershell-core\","`
pinned 布尔值	软件包的版本是否已固定以抑制升级返回：始终示例： `false`
packages 复杂类型	已安装软件包的列表返回：始终（除非 filter 设置为排除 packages）
package 字符串	软件包的名称返回：始终示例： `"vscode"`
version 字符串	软件包的版本返回：始终示例： `"1.27.2"`
sources 复杂类型	Chocolatey 源的列表返回：始终（除非 filter 设置为排除 sources）
admin_only 布尔值	该源是否仅对管理员可见返回：始终示例： `false`
allow_self_service 布尔值	是否允许使用自助服务使用该源返回：始终示例： `false`
bypass_proxy 布尔值	该源是否可以明确绕过已配置的代理返回：始终示例： `true`
certificate 字符串	用于 X509 身份验证源的 PFX 证书的路径返回：始终示例： `"C:\\chocolatey\\cert.pfx"`
disabled 布尔值	该源是否已禁用返回：始终示例： `false`
name 字符串	源的名称返回：始终示例： `"chocolatey"`
priority 整数	此源的优先级顺序，越低越好，0 表示没有优先级返回：始终示例： `0`
source 字符串	源，可以是文件夹/文件或 URL 返回：始终示例： `"https://community.chocolatey.org/api/v2/"`
source_username 字符串	用于访问身份验证源的用户名返回：始终示例： `"username"`

作者

Simon Bärlocher (@sbaerlocher)
ITIGO AG (@itigoag)
Rain Sallow (@vexx32)
Josh King (@windos)