summaryrefslogtreecommitdiff
path: root/windows
diff options
context:
space:
mode:
Diffstat (limited to 'windows')
-rw-r--r--windows/win_get_url.py17
1 files changed, 16 insertions, 1 deletions
diff --git a/windows/win_get_url.py b/windows/win_get_url.py
index 1492cb44..5ce3bd52 100644
--- a/windows/win_get_url.py
+++ b/windows/win_get_url.py
@@ -47,7 +47,10 @@ options:
description:
- If C(yes), will always download the file. If C(no), will only
download the file if it does not exist or the remote file has been
- modified more recently than the local file.
+ modified more recently than the local file. This works by sending
+ an http HEAD request to retrieve last modified time of the requested
+ resource, so for this to work, the remote web server must support
+ HEAD requests.
version_added: "2.0"
required: false
choices: [ "yes", "no" ]
@@ -109,3 +112,15 @@ $ ansible -i hosts -c winrm -m win_get_url -a "url=http://www.example.com/earthr
proxy_username: 'username'
proxy_password: 'password'
'''
+RETURN = '''
+url:
+ description: requested url
+ returned: always
+ type: string
+ sample: 'http://www.example.com/earthrise.jpg'
+dest:
+ description: destination file/path
+ returned: always
+ type: string
+ sample: 'C:\Users\RandomUser\earthrise.jpg'
+'''