windows: Various small documentation fixes (#23138)

This commit is contained in:
Dag Wieers 2017-05-09 03:03:56 +02:00 committed by Matt Davis
parent 5ab97b30cd
commit b58cf0d23a
6 changed files with 20 additions and 19 deletions

View file

@ -36,7 +36,7 @@ description:
options:
free_form:
description:
- the win_shell module takes a free form command to run. There is no parameter actually named 'free form'.
- The C(win_shell) module takes a free form command to run. There is no parameter actually named 'free form'.
See the examples!
required: true
creates:
@ -57,8 +57,9 @@ notes:
better to use the M(win_command) module instead. Best practices when writing
playbooks will follow the trend of using M(win_command) unless C(win_shell) is
explicitly required. When running ad-hoc commands, use your best judgement.
- WinRM will not return from a command execution until all child processes created have exited. Thus, it is not possible to use win_shell to spawn
long-running child or background processes. Consider creating a Windows service for managing background processes.
- WinRM will not return from a command execution until all child processes created have exited.
Thus, it is not possible to use C(win_shell) to spawn long-running child or background processes.
Consider creating a Windows service for managing background processes.
author:
- Matt Davis
'''