Merge pull request #1557 from jhawkesworth/win_copy_limitation_documentation

document file size limit for win_copy module
This commit is contained in:
Brian Coca 2015-06-19 10:09:07 -04:00
commit cf273bbaeb

View file

@ -47,9 +47,15 @@ options:
default: null default: null
author: "Jon Hawkesworth (@jhawkesworth)" author: "Jon Hawkesworth (@jhawkesworth)"
notes: notes:
- The "win_copy" module recursively copy facility does not scale to lots (>hundreds) of files. - The "win_copy" module is best used for small files only.
Instead, you may find it better to create files locally, perhaps using win_template, and This module should **not** be used for files bigger than 3Mb as
then use win_get_url to fetch them from your managed hosts into the correct location. this will result in a 500 response from the winrm host
and it will not be possible to connect via winrm again until the
windows remote management service has been restarted on the
windows host.
Files larger than 1Mb will take minutes to transfer.
The recommended way to transfer large files is using win_get_url
or collecting from a windows file share folder.
''' '''
EXAMPLES = ''' EXAMPLES = '''