salt.states.chocolatey

Manage Windows Packages using Chocolatey .. versionadded:: 2016.3.0

Note

Chocolatey pulls data from the Chocolatey internet database to determine current versions, find available versions, etc. This is normally a slow operation and may be optimized by specifying a local, smaller chocolatey repo.

salt.states.chocolatey.installed(name, version=None, source=None, force=False, pre_versions=False, install_args=None, override_args=False, force_x86=False, package_args=None, allow_multiple=False, execution_timeout=None)

Installs a package if not already installed

Parameters:
  • name (str) -- The name of the package to be installed. Required.

  • version (str) -- Install a specific version of the package. Defaults to the latest version. If the version is different to the one installed, then the specified version will be installed. Default is None.

  • source (str) -- Chocolatey repository (directory, share or remote URL, feed). None defaults to the official Chocolatey feed. Default is None.

  • force (bool) -- Reinstall the current version of an existing package. Do not use with allow_multiple. Default is False.

  • pre_versions (bool) -- Include pre-release packages. Default is False.

  • install_args (str) -- Install arguments you want to pass to the installation process, i.e. product key or feature list. Default is None.

  • override_args (bool) -- Set to True to override the original install arguments (for the native installer) in the package and use your own. When this is set to False, install_args will be appended to the end of the default arguments. Default is False.

  • force_x86 (bool) -- Force x86 (32bit) installation on 64bit systems. Default is False.

  • package_args (str) -- Arguments you want to pass to the package. Default is None.

  • allow_multiple (bool) --

    Allow multiple versions of the package to be installed. Do not use with force. Does not work with all packages. Default is False.

    New in version 2017.7.0.

  • execution_timeout (str) -- Chocolatey execution timeout value you want to pass to the installation process. Default is None.

Example:

install_some_package:
  chocolatey.installed:
    - name: packagename
    - version: '12.04'
    - source: 'mychocolatey/source'
    - force: True
salt.states.chocolatey.source_present(name, source_location, username=None, password=None, force=False, priority=None)

Adds a Chocolatey source if not already present.

Parameters:
  • name (str) -- The name of the source to be added as a chocolatey repository.

  • source (str) -- Location of the source you want to work with.

  • username (str) -- The username for a chocolatey source that needs authentication credentials.

  • password (str) -- The password for a chocolatey source that needx authentication credentials.

  • force (bool) -- Salt will not modify an existing repository with the same name. Set this option to True to update an existing repository.

  • priority (int) -- The priority order of this source as compared to other sources. Lower is better. Defaults to 0 (no priority). All priorities above 0 will be evaluated first, then zero-based values will be evaluated in config file order.

Example:

add_some_source:
  chocolatey.source_present:
    - name: reponame
    - source: https://repo.exemple.com
    - username: myuser
    - password: mypassword
    - priority: 100
salt.states.chocolatey.uninstalled(name, version=None, uninstall_args=None, override_args=False)

Uninstalls a chocolatey package

Parameters:
  • name (str) -- The name of the package to be uninstalled. Required.

  • version (str) -- Uninstalls a specific version of the package. Defaults to the latest version installed.

  • uninstall_args (str) -- A list of uninstall arguments you want to pass to the uninstallation process, i.e. product key or feature list

  • override_args (str) -- Set to True if you want to override the original uninstall arguments (for the native uninstaller) in the package and use your own. When this is set to False, uninstall_args will be appended to the end of the default arguments

Example:

remove_my_package:
  chocolatey.uninstalled:
    - name: mypackage
    - version: '21.5'
salt.states.chocolatey.upgraded(name, version=None, source=None, force=False, pre_versions=False, install_args=None, override_args=False, force_x86=False, package_args=None)

Upgrades a chocolatey package. Will install the package if not installed.

New in version 2018.3.0.

Parameters:
  • name (str) -- The name of the package to be installed. Required.

  • version (str) -- Install a specific version of the package. Defaults to latest version. If the version is greater than the one installed then the specified version will be installed. Default is None.

  • source (str) -- Chocolatey repository (directory, share or remote URL, feed). Defaults to the official Chocolatey feed. Default is None.

  • force (bool) -- True will reinstall an existing package with the same version. Default is False.

  • pre_versions (bool) -- True will include pre-release packages. Default is False.

  • install_args (str) -- Install arguments you want to pass to the installation process, i.e product key or feature list. Default is None.

  • override_args (bool) -- True will override the original install arguments (for the native installer) in the package and use those specified in install_args. False will append install_args to the end of the default arguments. Default is False.

  • force_x86 (bool) -- True forces 32bit installation on 64bit systems. Default is False.

  • package_args (str) -- Arguments you want to pass to the package. Default is None.

Example:

upgrade_some_package:
  chocolatey.upgraded:
    - name: packagename
    - version: '12.04'
    - source: 'mychocolatey/source'