Windows

Windows Working Group

The Windows Working Group collaborates on Windows and Windows-related technologies in Ansible.

News

• A total of 91 dedicated Windows modules ship with Ansible v2.7 !
• We have a Windows meeting agenda and a pinboard, subscribe to them to stay informed!
• We have a list of ideas and a progress tracker on this Wiki.
• From time to time we do sprints to help fight the growing issue and PR queue.

Community

Name	GitHub (+ IRC)	Role	Affiliation
Jordan Borean	jborean93	Lead	Red Hat/Ansible
Matt Davis	nitzmahone	Lead	Red Hat/Ansible
Dag Wieers	dagwieers / dag	Reviewer	Independent
John Hawkesworth	jhawkesworth	Reviewer
Trond Hindenes	trondhindenes	Reviewer
Michael Eaton	michaeldeaton / square1	Member	Independent

Add yourself to this list as a Reviewer (help review PRs) or as a Member (discuss issues/roadmap).

Meetings

If you want to bring up an issue, a review-request or a PR to discuss on the meeting, just put it on the meeting agenda.

We have weekly meetings on Tuesdays at 20:00 UTC on IRC channel #ansible-windows.

Meeting minutes and logs are available by channel or by team.

Community effort (help welcome !)

• Help with Windows issues -- reproduce, interact, fix/close
• Review Windows pull-requests -- review, feedback
• Test new Windows modules -- test, review
• Add integration tests to all Windows modules -- progress
• Add idempotency and check-mode to all Windows modules -- progress
• Windows feature parity with equiv. Python modules -- progress
• Add diff support to Windows modules -- progress

Individual actions

• Threaded Ansible implementation -- jimi-c
• Integrate Powershell coverage support -- nitzmahone #63
• Intermediate module output to support the 5 different streams of output -- nitzmahone, bcoca
• Using SSH as a transport for Windows -- jborean #47732

TODO

• Implement WinRM connection parameters (and general Windows options) to Ansible config -- #153 (comment)
• List new/missing facts from win_setup and make a plan -- #153 (comment)
• Create integration tests for glob-paths to determine scope of -LiteralPath issues #153 (comment)
• Implement a solution for updating facts from modules in a more granular fashion.

Roadmap

• Roadmap v2.8
• Roadmap v2.7
• Roadmap v2.6
• Roadmap v2.5
• Roadmap v2.4
• Roadmap v2.3
• Roadmap v2.2
• Roadmap v2.1

Pywinrm Work

Here is a list of things that need to be done in Pywinrm.

Nice to Have

• Bypass Proxy

  • https://github.com/diyan/pywinrm/pull/165 - (Chosen impl) http and https_proxy passed as separate args, no no_proxy
  • https://github.com/diyan/pywinrm/pull/151 - options are passed as 1 dict

• Allow custom CA paths

  • https://github.com/diyan/pywinrm/pull/182

• Automatically parse *_timeout_sec vars as an int and fail with a better error

  • https://github.com/diyan/pywinrm/pull/186

• Kerberos

  • https://github.com/diyan/pywinrm/pull/144 - fix to override default service of HTTP (fixed in 186
  • https://github.com/diyan/pywinrm/pull/192 - message encryption

• SSL Warning Suppression RHEL7

  • https://github.com/diyan/pywinrm/pull/176

• Send Message Retry

  • https://github.com/diyan/pywinrm/pull/175
  • https://github.com/diyan/pywinrm/pull/174 - Dag's implementation

• Better Exception Errors

  • https://github.com/diyan/pywinrm/pull/189

Don't Affect Ansible

• Python 3 Fixes

  • https://github.com/diyan/pywinrm/pull/178 - encoding fix for stream output (is this still an issue)
  • https://github.com/diyan/pywinrm/pull/137 - fix when running run_ps on Python 3 so stderr is a string not bytes
  • https://github.com/diyan/pywinrm/pull/112 - another fix for the above

• Command Output

  • https://github.com/diyan/pywinrm/pull/170 - for clixml
  • https://github.com/diyan/pywinrm/pull/168 - convert exception output to bytes (not really needed)

• Other

  • https://github.com/diyan/pywinrm/pull/145 - run_ps to use UTF-8 instead of UTF-16
  • https://github.com/diyan/pywinrm/pull/132 - override close session to not close the shell but still close TCP session
  • https://github.com/diyan/pywinrm/pull/116 - various changes such as stdin input and lifetime fixes
  • https://github.com/diyan/pywinrm/pull/92 - IPv6 support for the basic API
  • https://github.com/diyan/pywinrm/pull/55 - live stdout
  • https://github.com/diyan/pywinrm/pull/42 - cli interface

Should be Closed

https://github.com/diyan/pywinrm/pull/172 - example still isn't really correct

https://github.com/diyan/pywinrm/pull/115 - python-devel for Kerb (already done)

https://github.com/diyan/pywinrm/pull/122 - don't use, set's port based on ntlm transport

https://github.com/diyan/pywinrm/pull/160 - implemented with https://github.com/diyan/pywinrm/pull/182

https://github.com/diyan/pywinrm/pull/138 - implemented with https://github.com/diyan/pywinrm/pull/182

https://github.com/diyan/pywinrm/pull/131 - implemented with https://github.com/diyan/pywinrm/pull/189

DONE

• Propose backup-facility for some modules -- dagwieers #50033
• Speed up Windows CI testing using own dedicated environment -- nitzmahone, mattclay
• Make httptester available for Windows VMs (for testing win_get_url and win_uri) -- jborean93 #46606
• Create a diagnostic script for common WinRM configuration issues -- jborean93 #153 (comment)
• Add new DSC documentation and examples to existing Windows docs -- trondhindenes
• Improve the speed of win_copy for multiple files -- jborean93
• issue #19725: Use environment variable to find/use executable
• Mutually reference Windows and non-Windows modules in documentation -- dagwieers #25482
• Fix inconsistent parameters cfr. #20160 -- dagwieers #25398 #26464 #26466
• Re-enable non-pipeline mode for Powershell -- nitzmahone -- #25012
• Reimplementation of win_regedit module -- jborean93 #26468
• Implement absolute src= path for win_shortcut -- dagwieers #24494
• Ensure service accounts don't need NT AUTHORITY\ prepended for convenience~ (use module_utils to pick this up). -- jborean93 #153 (comment)
• Powershell module_utils loader -- nitzmahone #26932
• Add GitHub badges for PRs by-label for our Wiki -- dagwieers -- badges/shields#1020
• Document the old/new syntax for specifying a path (with backslashes) -- jhawkesworth docs #15787 #25278
• Restructure Windows documentation, start with demo structure -- jborean93
• Merge the winrm connection plugin docs -- nitzmahone
• Implement #AnsibleRequires functionality (for requirements other than module utils eg OS Version, become--nitzmahone -- meeting notes