diff --git a/lib/ansible/modules/windows/win_chocolatey.py b/lib/ansible/modules/windows/win_chocolatey.py index bcfba1f8874..c6633583951 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'''