community.windows.win_feature_info 模块 – 收集 Windows 功能信息

注意

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

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

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

要在 playbook 中使用它，请指定：community.windows.win_feature_info。

community.windows 1.4.0 中的新增功能

概要 

收集所有或特定已安装的 Windows 功能的信息。

参数 

参数	注释
名称字符串	如果指定，则使用它来匹配要获取信息的 Windows 功能的 `name`。可以是通配符以匹配多个功能，但通配符将仅在功能的 `name` 上匹配。如果省略，则将返回所有功能。默认值： `"*"`

另请参阅 

另请参阅

ansible.windows.win_feature: 在 Windows Server 上安装和卸载 Windows 功能。

示例 

- name: Get info for all installed features
  community.windows.win_feature_info:
  register: feature_info
- name: Get info for a single feature
  community.windows.win_feature_info:
    name: DNS
  register: feature_info
- name: Find all features that start with 'FS'
  ansible.windows.win_feature_info:
    name: FS*

返回值 

常见的返回值记录在此处，以下是此模块独有的字段

键	描述
存在布尔值	是否根据指定的条件找到了任何功能。返回：总是示例： `true`
功能列表 / 元素=字典	根据条件找到的功能列表。如果没有找到任何功能，则将是一个空列表。返回：总是
additional_info 字典	功能所需并将在其中运行的特权列表返回：成功
install_name 字符串	触发后要执行的操作，可以是 `start_feature` 或 `stop_feature`。返回：成功示例： `"ADCertificateServicesRole"`
major_version 整数	功能 `name` 的主要版本。返回：成功示例： `8`
minor_version 整数	功能 `name` 的次要版本。返回：成功示例： `0`
number_id_version 整数	功能 `name` 的数字 ID。返回：成功示例： `16`
best_practices_model_id 字符串	功能 `name` 的 BestPracticesModelId。返回：成功示例： `"Microsoft/Windows/UpdateServices"`
depends_on 列表 / 元素=字符串	当触发 `run_command` 失败操作时将运行的命令行。返回：成功示例： `["Web-Static-Content", "Web-Default-Doc"]`
depth 整数	`name` 功能的深度。返回：成功示例： `1`
description 字符串	该功能的描述。返回：成功示例： `"Windows 功能的示例描述。"`
display_name 字符串	找到的功能的显示名称。返回：成功示例： `"Active Directory Certificate Services"`
event_query 字符串	功能 `name` 的 EventQuery。如果不存在，则这将为 `null` 返回：成功示例： `"IPAMServer.Events.xml"`
feature_type 字符串	`name` 的功能类型。值将为 `Role`、`Role Service` 或 `Feature` 之一。返回：成功示例： `"Feature"`
install_state 字符串	`name` 的安装状态。值将为 `Available`、`Removed` 或 `Installed` 之一。返回：成功示例： `"Installed"`
installed 布尔值	是否安装了 `name` 指定的功能。返回：成功示例： `false`
名称字符串	找到的功能的名称。返回：成功示例： `"AD-Certificate"`
parent 字符串	如果存在，则为功能 `name` 的父级。返回：成功示例： `"PowerShellRoot"`
路径字符串	`name` 功能的路径。返回：成功示例： `"WoW64 Support"`
post_configuration_needed 布尔值	指示功能 `name` 是否需要配置后处理。返回：成功示例： `false`
server_component_descriptor 字符串	`name` 功能的描述符。返回：成功示例： `"ServerComponent_AD_Certificate"`
sub_features 列表 / 元素=字符串	`name` 功能的子功能名称列表。返回：成功示例： `["WAS-Process-Model", "WAS-NET-Environment", "WAS-Config-APIs"]`
system_service 列表 / 元素=字符串	功能 `name` 安装的服务名称。返回：成功示例： `["iisadmin", "w3svc"]`

作者

Larry Lane (@gamethis)