summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorjhawkesworth <jhawkesworth@users.noreply.github.com>2017-09-29 10:47:38 +0100
committerjborean93 <jborean93@gmail.com>2017-09-30 08:23:30 +1000
commit6d82ef83781ab30c8aa3988c37faf532a6b9f513 (patch)
treedc6bd4b2c3b785cb4c89ac8584dbeab2685bb05e /lib
parent73355d541a65e926272fed2e74899be856e2514a (diff)
downloadansible-6d82ef83781ab30c8aa3988c37faf532a6b9f513.tar.gz
win_chocolately document improvedments, mention win_hotfix and use of become (#31085)
(cherry picked from commit 04afacc2ee127ce9455c731413739e64e47e9065)
Diffstat (limited to 'lib')
-rw-r--r--lib/ansible/modules/windows/win_chocolatey.py14
1 files changed, 12 insertions, 2 deletions
diff --git a/lib/ansible/modules/windows/win_chocolatey.py b/lib/ansible/modules/windows/win_chocolatey.py
index bcfba1f887..c663358395 100644
--- a/lib/ansible/modules/windows/win_chocolatey.py
+++ b/lib/ansible/modules/windows/win_chocolatey.py
@@ -133,6 +133,9 @@ notes:
- When using verbosity 4 (C(-vvvv)) the C(stdout) output will be more verbose.
- When using verbosity 5 (C(-vvvvv)) the C(stdout) output will include debug output.
- This module will install or upgrade Chocolatey when needed.
+- Some packages need an interactive user logon in order to install. You can use (C(become)) to achieve this.
+- Even if you are connecting as local Administrator, using (C(become)) to become Administrator will give you an interactive user logon, see examples below.
+- Use (M(win_hotfix) to install hotfixes instead of (M(win_chocolatey)) as (M(win_hotfix)) avoids using wusa.exe which cannot be run remotely.
author:
- Trond Hindenes (@trondhindenes)
- Peter Mounce (@petemounce)
@@ -173,10 +176,10 @@ EXAMPLES = r'''
name: git
state: absent
-- name: install multiple packages
+- name: Install multiple packages
win_chocolatey:
name: '{{ item }}'
- state: absent
+ state: present
with_items:
- pscx
- windirstat
@@ -202,6 +205,13 @@ EXAMPLES = r'''
proxy_url: http://proxy-server:8080/
proxy_username: user with \"escaped\" double quotes
proxy_password: pass with \"escaped\" double quotes
+
+- name: Install a package that requires 'become'
+ win_chocolatey:
+ name: officepro2013
+ become: yes
+ become_user: Administrator
+ become_method: runas
'''
RETURN = r'''