chocolatey.chocolatey.win_chocolatey_config – Manages Chocolatey config settings

Note

This plugin is part of the chocolatey.chocolatey collection (version 1.1.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install chocolatey.chocolatey.

To use it in a playbook, specify: chocolatey.chocolatey.win_chocolatey_config.

New in version 0.2.7: of chocolatey.chocolatey

Synopsis

  • Used to manage Chocolatey config settings as well as unset the values.

Parameters

Parameter

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.

Choices:

  • absent

  • present ← (default)

value

string

Used when state=present that contains the value to set for the config setting.

Cannot be null or an empty string, use state=absent to unset a config value instead.

See Also

See also

M(win_chocolatey)

The official documentation on the win_chocolatey module.

M(win_chocolatey_facts)

The official documentation on the win_chocolatey_facts module.

M(win_chocolatey_feature)

The official documentation on the win_chocolatey_feature module.

M(win_chocolatey_source)

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

Authors

  • Jordan Borean (@jborean93)