ansible.builtin.win_feature (v2.3.2.0-1) — module

Install Ansible via pip

Install with pip install ansible==2.3.2.0.post1

Description

Installs or uninstalls Windows Roles or Features on Windows Server. This module uses the Add/Remove-WindowsFeature Cmdlets on Windows 2008 and Install/Uninstall-WindowsFeature Cmdlets on Windows 2012, which are not available on client os machines.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Install IIS (Web-Server and Web-Common-Http)
  win_feature:
    name: Web-Server,Web-Common-Http
    state: present

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Install IIS Web-Server with sub features and management tools
  win_feature:
    name: Web-Server
    state: present
    restart: True
    include_sub_features: True
    include_management_tools: True

Inputs

    
name:
    description:
    - Names of roles or features to install as a single feature or a comma-separated list
      of features
    required: true

state:
    choices:
    - present
    - absent
    default: present
    description:
    - State of the features or roles on the system

source:
    choices:
    - ' {driveletter}:\sources\sxs'
    - ' {IP}\Share\sources\sxs'
    description:
    - Specify a source to install the feature from.
    - Not supported in Windows 2008. If present when using Windows 2008 this option will
      be ignored.
    version_added: '2.1'
    version_added_collection: ansible.builtin

restart:
    choices:
    - true
    - false
    description:
    - Restarts the computer automatically when installation is complete, if restarting
      is required by the roles or features installed.

include_sub_features:
    choices:
    - true
    - false
    description:
    - Adds all subfeatures of the specified feature

include_management_tools:
    choices:
    - true
    - false
    description:
    - Adds the corresponding management tools to the specified feature.
    - Not supported in Windows 2008. If present when using Windows 2008 this option will
      be ignored.