Note

The documentation you're currently reading is for version 3.2dev. Click here to view documentation for the latest stable version.

WinRM Runners Configuration

Supported Windows Versions

WinRM runners have been tested on the following versions of Windows:

  • Windows Server 2008

  • Windows Server 2012

  • Windows Server 2016

The underlying library, pywinrm, we use to talk to the Windows hosts should work with other versions (2000/XP/2003/Vista/8/10), but we haven’t tested our runners with those versions, so we can’t guarantee it will work.

Support Authentication Transports

The pywinrm library supports a variety of different transport options. Currently the only supported transports are:

  • basic

  • plaintext

  • ntlm

Other transport mechanisms required system-level configuration on the StackStorm host and potentially also on the Windows host. Support for additional transports may be added in the future.

Configuring your Window Server for Remote Access

For StackStorm to be able to run actions on your Windows servers, you need to configure WinRM by executing the ConfigureRemotingForAnsible.ps1 script from the Ansible project. This script enables WinRM, configures the firewall, and generates an SSL certificate.

# download the script (feel free to download it manually, if you like)
(New-Object System.Net.WebClient).DownloadFile('https://raw.githubusercontent.com/ansible/ansible/devel/examples/scripts/ConfigureRemotingForAnsible.ps1', './ConfigureRemotingForAnsible.ps1')

# execute the script
./ConfigureRemotingForAnsible.ps1

We recommend executing this script on your Windows templates, that way WinRM is configured and available immediately when a new VM is cloned.

Questions? Problems? Suggestions? Engage!