On this page
win_chocolatey_config – Manages Chocolatey config settings
New in version 2.7.
Synopsis
- Used to manage Chocolatey config settings as well as unset the values.
Parameters
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| name 
        string / required
        | 
        The name of the config setting to manage.
        
        See https://chocolatey.org/docs/chocolatey-configuration for a list of valid configuration settings that can be changed.
        
        Any config values that contain encrypted values like a password are not idempotent as the plaintext value cannot be read.
        | |
| state 
        string
        | 
 | 
        When  absent, it will ensure the setting is unset or blank.
        When  present, it will ensure the setting is set to the value of value. | 
| value 
        string
        | 
        Used when  state=presentthat contains the value to set for the config setting.
        Cannot be null or an empty string, use  state=absentto unset a config value instead. | 
See Also
See also
- win_chocolatey – Manage packages using chocolatey
- The official documentation on the win_chocolatey module.
- win_chocolatey_facts – Create a facts collection for Chocolatey
- The official documentation on the win_chocolatey_facts module.
- win_chocolatey_feature – Manages Chocolatey features
- The official documentation on the win_chocolatey_feature module.
- win_chocolatey_source – Manages Chocolatey sources
- The official documentation on the win_chocolatey_source module.
Examples
- name: Set the cache location
  win_chocolatey_config:
    name: cacheLocation
    state: present
    value: D:\chocolatey_temp
- name: Unset the cache location
  win_chocolatey_config:
    name: cacheLocation
    state: absent
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Jordan Borean (@jborean93)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
 https://docs.ansible.com/ansible/2.9/modules/win_chocolatey_config_module.html