summaryrefslogtreecommitdiff
path: root/windows/win_copy.py
diff options
context:
space:
mode:
authorJon Hawkesworth <jhawkesworth@users.noreply.github.com>2015-06-19 08:52:43 +0100
committerJon Hawkesworth <jhawkesworth@users.noreply.github.com>2015-06-19 08:52:43 +0100
commit93c2f9245aa3c75272df7547fac3d68718e80243 (patch)
treefe5a2e7453c3b83b5cd9f7638ec9923c57cf0f9d /windows/win_copy.py
parent6449a01311b2663dd152fdcb49d8c3952386bc5d (diff)
downloadansible-modules-core-93c2f9245aa3c75272df7547fac3d68718e80243.tar.gz
document file size limit for win_copy module
Diffstat (limited to 'windows/win_copy.py')
-rw-r--r--windows/win_copy.py12
1 files changed, 9 insertions, 3 deletions
diff --git a/windows/win_copy.py b/windows/win_copy.py
index 54f035b1..efdebc5a 100644
--- a/windows/win_copy.py
+++ b/windows/win_copy.py
@@ -47,9 +47,15 @@ options:
default: null
author: "Jon Hawkesworth (@jhawkesworth)"
notes:
- - The "win_copy" module recursively copy facility does not scale to lots (>hundreds) of files.
- Instead, you may find it better to create files locally, perhaps using win_template, and
- then use win_get_url to fetch them from your managed hosts into the correct location.
+ - The "win_copy" module is best used for small files only.
+ This module should **not** be used for files bigger than 3Mb as
+ 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 = '''