Skip to content

Latest commit

 

History

History
525 lines (490 loc) · 23.3 KB

community.windows.win_feature_info_module.rst

File metadata and controls

525 lines (490 loc) · 23.3 KB

community.windows.win_feature_info

Gather information about Windows features

Version added: 1.4.0

Synopsis

  • Gather information about all or a specific installed Windows feature(s).

Parameters

Parameter Choices/Defaults Comments
name
string
Default:
"*"
If specified, this is used to match the name of the Windows feature to get the info for.
Can be a wildcard to match multiple features but the wildcard will only be matched on the name of the feature.
If omitted then all features will returned.

See Also

.. seealso::

   :ref:`ansible.windows.win_feature_module`
      The official documentation on the **ansible.windows.win_feature** module.

Examples

- 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*

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
exists
boolean
always
Whether any features were found based on the criteria specified.

Sample:
True
features
list / elements=dictionary
always
A list of feature(s) that were found based on the criteria.
Will be an empty list if no features were found.
 
additional_info
dictionary
A list of privileges that the feature requires and will run with
   
install_name
string
The action to perform once triggered, can be start_feature or stop_feature.

Sample:
ADCertificateServicesRole
   
major_version
integer
Major Version of feature name.

Sample:
8
   
minor_version
integer
Minor Version of feature name.
   
number_id_version
integer
Numberic Id of feature name.

Sample:
16
 
best_practices_model_id
string
BestPracticesModelId for feature name.

Sample:
Microsoft/Windows/UpdateServices
 
depends_on
list / elements=string
The command line that will be run when a run_command failure action is fired.

Sample:
['Web-Static-Content', 'Web-Default-Doc']
 
depth
integer
Depth of name feature.

Sample:
1
 
description
string
The description of the feature.

Sample:
Example description of the Windows feature.
 
display_name
string
The Display name of feature found.

Sample:
Active Directory Certificate Services
 
event_query
string
The EventQuery for feature name.
This will be null if None Present

Sample:
IPAMServer.Events.xml
 
feature_type
string
The Feature Type of name.
Values will be one of Role, Role Service, Feature.

Sample:
Feature
 
install_state
string
The Install State of name.
Values will be one of Available, Removed, Installed.

Sample:
Installed
 
installed
boolean
Whether the feature by name is installed.
 
name
string
Name of feature found.

Sample:
AD-Certificate
 
parent
string
The parent of feature name if present.

Sample:
PowerShellRoot
 
path
string
The Path of name feature.

Sample:
WoW64 Support
 
post_configuration_needed
boolean
Tells if Post Configuration is needed for feature name.
 
server_component_descriptor
string
Descriptor of name feature.

Sample:
ServerComponent_AD_Certificate
 
sub_features
list / elements=string
List of sub features names of feature name.

Sample:
['WAS-Process-Model', 'WAS-NET-Environment', 'WAS-Config-APIs']
 
system_service
list / elements=string
The name of the service installed by feature name.

Sample:
['iisadmin', 'w3svc']


Status

Authors

  • Larry Lane (@gamethis)