Windows module: win_optional_feature for Windows workstations (#53709)

* initial commit

* fix execute and \r\n

* \r attempt 2

* updated with integration tests and using new csharp import

* Apply suggestions from code review

Co-Authored-By: rcanderson23 <rcanderson23@gmail.com>

* fixed small docuement inaccuracies wrt returns

* removal of state in feature result

* removal of rc

* small fixes suggested in code review

* fixed variable assigning to result

* addition of comments on conditionals for clarity on matching

* swap logic of check_mode

* set $reboot_required so it is always returned

* removal of extraneous return information

* addition of integration tests

* set installation of parent features to true

* remove 2008 from tests

* changed test for TelnetClient from NetFx3

* change of tabs to spaces

* Add test check for OS version

lib/ansible/modules/windows/win_optional_feature.py

@@ -0,0 +1,83 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# Copyright: (c) 2019, Carson Anderson <rcanderson23@gmail.com>
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+# this is a windows documentation stub.  actual code lives in the .ps1
+# file of the same name
+
+ANSIBLE_METADATA = {'metadata_version': '1.1',
+                    'status': ['preview'],
+                    'supported_by': 'community'}
+
+DOCUMENTATION = r'''
+---
+module: win_optional_feature
+version_added: "2.8"
+short_description: Manage optional Windows features
+description:
+    - Install or uninstall optional Windows features on non-Server Windows.
+    - This module uses the C(Enable-WindowsOptionalFeature) and C(Disable-WindowsOptionalFeature) cmdlets.
+options:
+  name:
+    description:
+      - The name of the feature to install.
+      - This relates to C(FeatureName) in the Powershell cmdlet.
+      - To list all available features use the PowerShell command C(Get-WindowsOptionalFeature).
+    type: str
+    required: yes
+  state:
+    description:
+      - Whether to ensure the feature is absent or present on the system.
+    type: str
+    choices: [ absent, present ]
+    default: present
+  include_parent:
+    description:
+      - Whether to enable the parent feature and the parent's dependencies.
+    type: bool
+    default: no
+  source:
+    description:
+      - Specify a source to install the feature from.
+      - Can either be C({driveletter}:\sources\sxs) or C(\\{IP}\share\sources\sxs).
+    type: str
+seealso:
+- module: win_chocolatey
+- module: win_feature
+- module: win_package
+author:
+    - Carson Anderson (@rcanderson23)
+'''
+
+EXAMPLES = r'''
+- name: Install .Net 3.5
+  win_optional_feature:
+    name: NetFx3
+    state: present
+
+- name: Install .Net 3.5 from source
+  win_optional_feature:
+    name: NetFx3
+    source: \\share01\win10\sources\sxs
+    state: present
+
+- name: Install Microsoft Subsystem for Linux
+  win_optional_feature:
+    name: Microsoft-Windows-Subsystem-Linux
+    state: present
+  register: wsl_status
+
+- name: Reboot if installing Linux Subsytem as feature requires it
+  win_reboot:
+  when: wsl_status.reboot_required
+'''
+
+RETURN = r'''
+reboot_required:
+    description: True when the target server requires a reboot to complete updates
+    returned: success
+    type: bool
+    sample: true
+'''