chocolatey.chocolatey.win_chocolatey_config – Manages Chocolatey config settings

Note

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

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 2.7: of chocolatey.chocolatey

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
    Choices:
  • absent
  • present ←
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=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

win_chocolatey

The official documentation on the win_chocolatey module.

win_chocolatey_facts

The official documentation on the win_chocolatey_facts module.

win_chocolatey_feature

The official documentation on the win_chocolatey_feature module.

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)