From 61a06473ec93a097d47099ef4312ed3be1b1d9d9 Mon Sep 17 00:00:00 2001 From: Paul Durivage Date: Thu, 19 Jun 2014 13:16:55 -0500 Subject: [PATCH] Add documentation for win_feature module --- library/windows/win_feature | 54 +++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 library/windows/win_feature diff --git a/library/windows/win_feature b/library/windows/win_feature new file mode 100644 index 0000000000..6c64c06848 --- /dev/null +++ b/library/windows/win_feature @@ -0,0 +1,54 @@ +DOCUMENTATION = ''' +--- +module: win_get_url +version_added: "1.7" +short_description: Fetches a file from a given URL +description: + - Fetches a file from a URL and saves to locally +options: + name: + description: + - Names of roles or features to install as a single feature or a comma-separated list of features + required: true + default: null + aliases: [] + state: + description: + - State of the features or roles on the system + required: false + choices: + - present + - absent + default: present + aliases: [] + restart: + description: + - Restarts the computer automatically when installation is complete, if restarting is required by the roles or features installed. + choices: + - yes + - no + default: null + aliases: [] +author: Paul Durivage +''' + +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 +'''