diff options
author | Craig Ackerman <craig.ackerman@gmail.com> | 2014-06-18 16:48:52 +0000 |
---|---|---|
committer | Matt Martz <matt@sivel.net> | 2014-06-19 14:24:15 -0500 |
commit | fab0374572c5450bfb145017cce4372f23462345 (patch) | |
tree | 69fa7810215653b59579c2ed74bf6448cfc4c5e6 | |
parent | 97f4f56286fd7b5de27d1e5c01a15e4a1dcc8a6a (diff) | |
download | ansible-fab0374572c5450bfb145017cce4372f23462345.tar.gz |
Added Windows intro content
-rw-r--r-- | docsite/rst/intro_windows.rst | 33 |
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: |