Set force=yes as the default, add force parameter to module docs.

This commit is contained in:
Chris Church 2015-07-10 16:33:00 -04:00 committed by Matt Clay
parent 5efeeb156b
commit 31a01305ba
2 changed files with 19 additions and 5 deletions

View file

@ -40,7 +40,7 @@ Else {
Fail-Json $result "missing required argument: dest" Fail-Json $result "missing required argument: dest"
} }
$force = Get-Attr -obj $params -name "force" "no" | ConvertTo-Bool $force = Get-Attr -obj $params -name "force" "yes" | ConvertTo-Bool
If ($force -or -not (Test-Path $dest)) { If ($force -or -not (Test-Path $dest)) {
$client = New-Object System.Net.WebClient $client = New-Object System.Net.WebClient

View file

@ -27,20 +27,28 @@ module: win_get_url
version_added: "1.7" version_added: "1.7"
short_description: Fetches a file from a given URL short_description: Fetches a file from a given URL
description: description:
- Fetches a file from a URL and saves to locally - Fetches a file from a URL and saves to locally
options: options:
url: url:
description: description:
- The full URL of a file to download - The full URL of a file to download
required: true required: true
default: null default: null
aliases: []
dest: dest:
description: description:
- The absolute path of the location to save the file at the URL. Be sure to include a filename and extension as appropriate. - The absolute path of the location to save the file at the URL. Be sure
to include a filename and extension as appropriate.
required: true
default: null
force:
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.
version_added: "2.0"
required: false required: false
choices: [ "yes", "no" ]
default: yes default: yes
aliases: []
author: "Paul Durivage (@angstwad)" author: "Paul Durivage (@angstwad)"
''' '''
@ -54,4 +62,10 @@ $ ansible -i hosts -c winrm -m win_get_url -a "url=http://www.example.com/earthr
win_get_url: win_get_url:
url: 'http://www.example.com/earthrise.jpg' url: 'http://www.example.com/earthrise.jpg'
dest: 'C:\Users\RandomUser\earthrise.jpg' dest: 'C:\Users\RandomUser\earthrise.jpg'
- name: Download earthrise.jpg to 'C:\Users\RandomUser\earthrise.jpg' only if modified
win_get_url:
url: 'http://www.example.com/earthrise.jpg'
dest: 'C:\Users\RandomUser\earthrise.jpg'
force: no
''' '''