ansible.windows.win_feature – Installs and uninstalls Windows Features on Windows Server

Note

This plugin is part of the ansible.windows collection (version 1.8.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install ansible.windows.

To use it in a playbook, specify: ansible.windows.win_feature.

Synopsis

  • Installs or uninstalls Windows Roles or Features on Windows Server.

  • This module uses the Add/Remove-WindowsFeature Cmdlets on Windows 2008 R2 and Install/Uninstall-WindowsFeature Cmdlets on Windows 2012, which are not available on client os machines.

Parameters

Parameter

Comments

include_management_tools

boolean

Adds the corresponding management tools to the specified feature.

Not supported in Windows 2008 R2 and will be ignored.

Choices:

  • no ← (default)

  • yes

include_sub_features

boolean

Adds all subfeatures of the specified feature.

Choices:

  • no ← (default)

  • yes

name

list / elements=string / required

Names of roles or features to install as a single feature or a comma-separated list of features.

To list all available features use the PowerShell command Get-WindowsFeature.

source

string

Specify a source to install the feature from.

Not supported in Windows 2008 R2 and will be ignored.

Can either be {driveletter}:\sources\sxs or \\{IP}\share\sources\sxs.

state

string

State of the features or roles on the system.

Choices:

  • absent

  • present ← (default)

See Also

See also

chocolatey.chocolatey.win_chocolatey

The official documentation on the chocolatey.chocolatey.win_chocolatey module.

ansible.windows.win_package

The official documentation on the ansible.windows.win_package module.

Examples

- name: Install IIS (Web-Server only)
  ansible.windows.win_feature:
    name: Web-Server
    state: present

- name: Install IIS (Web-Server and Web-Common-Http)
  ansible.windows.win_feature:
    name:
    - Web-Server
    - Web-Common-Http
    state: present

- name: Install NET-Framework-Core from file
  ansible.windows.win_feature:
    name: NET-Framework-Core
    source: C:\Temp\iso\sources\sxs
    state: present

- name: Install IIS Web-Server with sub features and management tools
  ansible.windows.win_feature:
    name: Web-Server
    state: present
    include_sub_features: yes
    include_management_tools: yes
  register: win_feature

- name: Reboot if installing Web-Server feature requires it
  ansible.windows.win_reboot:
  when: win_feature.reboot_required

Return Values

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

Key

Description

exitcode

string

The stringified exit code from the feature installation/removal command.

Returned: always

Sample: “Success”

feature_result

complex

List of features that were installed or removed.

Returned: success

display_name

string

Feature display name.

Returned: always

Sample: “Telnet Client”

id

integer

A list of KB article IDs that apply to the update.

Returned: always

Sample: 44

message

list / elements=string

Any messages returned from the feature subsystem that occurred during installation or removal of this feature.

Returned: always

Sample: []

reboot_required

boolean

True when the target server requires a reboot as a result of installing or removing this feature.

Returned: always

Sample: true

restart_needed

boolean

DEPRECATED in Ansible 2.4 (refer to reboot_required instead). True when the target server requires a reboot as a result of installing or removing this feature.

Returned: always

Sample: true

skip_reason

string

The reason a feature installation or removal was skipped.

Returned: always

Sample: “NotSkipped”

success

boolean

If the feature installation or removal was successful.

Returned: always

Sample: true

reboot_required

boolean

True when the target server indicates a reboot is required (no further updates can be installed until after a reboot).

This my be true even if not change had occurred as the value is derived from the server state.

Returned: success

Sample: true

Authors

  • Paul Durivage (@angstwad)

  • Trond Hindenes (@trondhindenes)