summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCraig Ackerman <craig.ackerman@gmail.com>2014-06-18 16:48:52 +0000
committerMatt Martz <matt@sivel.net>2014-06-19 14:24:15 -0500
commitfab0374572c5450bfb145017cce4372f23462345 (patch)
tree69fa7810215653b59579c2ed74bf6448cfc4c5e6
parent97f4f56286fd7b5de27d1e5c01a15e4a1dcc8a6a (diff)
downloadansible-fab0374572c5450bfb145017cce4372f23462345.tar.gz
Added Windows intro content
-rw-r--r--docsite/rst/intro_windows.rst33
1 files changed, 30 insertions, 3 deletions
diff --git a/docsite/rst/intro_windows.rst b/docsite/rst/intro_windows.rst
index aa6d51e0bb..af1e25a427 100644
--- a/docsite/rst/intro_windows.rst
+++ b/docsite/rst/intro_windows.rst
@@ -106,11 +106,38 @@ Additional modules may be submitted as pull requests to github.
.. _windows_system_prep:
System Prep
-```````````
+``````````
+
+In order for Ansible to manage your windows machines, you will have to enable Powershell remoting first, which also enables WinRM::
+
+From the Windows host, launch the Powershell Client. For information on Powershell, visit 'Microsoft's Using Powershell article <http://technet.microsoft.com/en-us/library/dn425048.aspx>'
+
+In the powershell session, run the following to enable PS Remoting and set the execution policy
+
+.. code-block:: bash
+
+ $ Enable-PSRemoting -Force
+ $ Set-ExecutionPolicy RemoteSigned
+
+If your Windows firewall is enabled, you must also run the following command to allow firewall access to the public firewall profile::
+
+ .. code-block:: bash
+
+ $ Windows 2012 / 2012R2
+ $ Set-NetFirewallRule -Name "WINRM-HTTP-In-TCP-PUBLIC" -RemoteAddress Any
+ $ Windows 2008 / 2008R2
+ $ NetSH ADVFirewall Set AllProfiles Settings remotemanagement Enable
+
+Best Practices
+By default, Powershell remoting enables an HTTP listener. The following commands enable an HTTPS listener, which secures communication between the Control Machine and windows.
+
+.. code-block:: bash
+ $ Delete the http listener
+ $ WinRM delete winrm/config/listener?Address=*+Transport=HTTP
+ $ Create the https listener
+ $ Insert code here
-In order for Ansible to manage your windows machines you will have to enable powershell remoting first::
- How to do it goes here
.. _windows_and_linux_control_machine: