win_feature - Installs and uninstalls Windows Features

Author:Paul Durivage / Trond Hindenes

Synopsis

New in version 1.7.

Installs or uninstalls Windows Roles or Features

Options

parameter required default choices comments
include_management_tools no
  • True
  • False
Adds the corresponding management tools to the specified feature
include_sub_features no
  • True
  • False
Adds all subfeatures of the specified feature
name yes
    Names of roles or features to install as a single feature or a comma-separated list of features
    restart no
    • True
    • False
    Restarts the computer automatically when installation is complete, if restarting is required by the roles or features installed.
    state no present
    • present
    • absent
    State of the features or roles on the system

    Examples


    # This installs IIS.
    # The names of features available for install can be run by running the following Powershell Command:
    # PS C:\Users\Administrator> Import-Module ServerManager; Get-WindowsFeature
    $ ansible -i hosts -m win_feature -a "name=Web-Server" all
    $ ansible -i hosts -m win_feature -a "name=Web-Server,Web-Common-Http" all
    
    
    # Playbook example
    ---
    - name: Install IIS
      hosts: all
      gather_facts: false
      tasks:
        - name: Install IIS
          win_feature:
            name: "Web-Server"
            state: absent
            restart: yes
            include_sub_features: yes
            include_management_tools: yes
    

    Table Of Contents

    Previous topic

    Windows Modules

    Next topic

    win_get_url - Fetches a file from a given URL