community.windows.win_feature_info 模块 – 收集有关 Windows 功能的信息

注意

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

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

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

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

community.windows 1.4.0 中的新增功能

概要

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

参数

参数	注释
name 字符串	如果指定，则用于匹配 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*

返回值

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

键	描述
exists 布尔值	是否根据指定的条件找到任何功能。 返回： 始终 示例： true
features 列表 / 元素=字典	根据条件找到的功能列表。 如果未找到任何功能，则为空列表。 返回： 始终
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 字符串	功能的描述。 返回： 成功 示例： "Example description of the Windows feature."
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
name 字符串	找到的功能名称。 返回： 成功 示例： "AD-Certificate"
parent 字符串	如果存在，则为功能name的父级。 返回： 成功 示例： "PowerShellRoot"
path 字符串	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)

集合链接

• 问题跟踪器
• 代码库（源代码）
• 通信