New module: Add module to add/remove a network static route on windows (windows/win_route) (#23405)

* adds win_route windows module

* fix documentation indent

* fix documentation pep8 issues

* fix documentation issues

* genaral code review

* changed 'supported_by' in doc, supports_check_mode removed

* use of powershell cmdlet instead of route command, destnation in CIDR format, adds check mode support

* adds win_psmodule module

* documentation review

* documentation review

* removed files accidentatlly pushed

* add integration tests, add return in documentation

* add conditional statement in test, add os requirementes in documentation

* fix documentation

* fix os check in tests

lib/ansible/modules/windows/win_route.py

@@ -0,0 +1,78 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# (c) 2017, Daniele Lazzari <lazzari@mailup.com>
+#
+# This file is part of Ansible
+#
+# Ansible is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Ansible is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
+
+# this is a windows documentation stub.  actual code lives in the .ps1
+# file of the same name
+
+ANSIBLE_METADATA = {'metadata_version': '1.0',
+                    'status': ['preview'],
+                    'supported_by': 'community'}
+
+DOCUMENTATION = r'''
+---
+module: win_route
+version_added: "2.4"
+short_description: Add or remove a static route.
+description:
+    - Add or remove a static route.
+options:
+  destination:
+    description:
+      - Destination IP address in CIDR format (ip address/prefix lenght)
+    required: true
+  gateway:
+    description:
+        - Gateway used by the static route. If gateway is not provided it will be set to "0.0.0.0"
+  metric:
+    description:
+        - Metric used by the static route.
+    default: 1
+  state:
+    description:
+      - If present, it adds a network static route.
+        If absent, it removes a network static route.
+    default: present
+notes:
+  - Works only with Windows 2012 R2 or latest.
+author: Daniele Lazzari
+'''
+
+EXAMPLES = r'''
+---
+
+- name: Add a network static route
+  win_route:
+    destination: 192.168.2.10/32
+    gateway: 192.168.1.1
+    metric: 1
+    state: present
+
+- name: Remove a network static route
+  win_route:
+    destination: 192.168.2.10/32
+    state: absent
+'''
+RETURN = r'''
+outpot:
+    description: A message describing the task result.
+    returned: always
+    type: string
+    sample: "Route added"
+'''