# salt.modules.chocolatey

A dead simple module wrapping calls to the Chocolatey package manager (http://chocolatey.org)

New in version Hydrogen.

`salt.modules.chocolatey.` `bootstrap`(force=False)

  Download and install the latest version of the Chocolatey package manager via the official bootstrap.

  Chocolatey requires Windows PowerShell and the .NET v4.0 runtime. Depending on the host's version of Windows, chocolatey.bootstrap will attempt to ensure these prerequisites are met by downloading and executing the appropriate installers from Microsoft.

  Note that if PowerShell is installed, you may have to restart the host machine for Chocolatey to work.

  force
    Run the bootstrap process even if Chocolatey is found in the path.

      salt '*' chocolatey.bootstrap
      salt '*' chocolatey.bootstrap force=True

`salt.modules.chocolatey.` `install`(name, version=None, source=None, force=False)

  Instructs Chocolatey to install a package.

  name
    The name of the package to be installed. Only accepts a single argument.
  version
    Install a specific version of the package. Defaults to latest version.
  source
    Chocolatey repository (directory, share or remote URL feed) the package comes from. Defaults to the official Chocolatey feed.
  force
    Reinstall the current version of an existing package.

  CLI Example:

      salt '*' chocolatey.install <package name>
      salt '*' chocolatey.install <package name> version=<package version>

`salt.modules.chocolatey.` `install_cygwin`(name)

  Instructs Chocolatey to install a package via Cygwin.

  name
    The name of the package to be installed. Only accepts a single argument.

  CLI Example:

      salt '*' chocolatey.install_cygwin <package name>

`salt.modules.chocolatey.` `install_gem`(name, version=None)

  Instructs Chocolatey to install a package via Ruby's Gems.

  name
    The name of the package to be installed. Only accepts a single argument.
  version
    Install a specific version of the package. Defaults to latest version available.

  CLI Example:

      salt '*' chocolatey.install_gem <package name>
      salt '*' chocolatey.install_gem <package name> version=<package version>

`salt.modules.chocolatey.` `install_missing`(name, version=None, source=None)

  Instructs Chocolatey to install a package if it doesn't already exist.

  name
    The name of the package to be installed. Only accepts a single argument.
  version
    Install a specific version of the package. Defaults to latest version available.
  source
    Chocolatey repository (directory, share or remote URL feed) the package comes from. Defaults to the official Chocolatey feed.

  CLI Example:

      salt '*' chocolatey.install_missing <package name>
      salt '*' chocolatey.install_missing <package name> version=<package version>

`salt.modules.chocolatey.` `install_python`(name, version=None)

  Instructs Chocolatey to install a package via Python's easy_install.

  name
    The name of the package to be installed. Only accepts a single argument.
  version
    Install a specific version of the package. Defaults to latest version available.

  CLI Example:

      salt '*' chocolatey.install_python <package name>
      salt '*' chocolatey.install_python <package name> version=<package version>

`salt.modules.chocolatey.` `install_webpi`(name)

  Instructs Chocolatey to install a package via the Microsoft Web PI service.

  name
    The name of the package to be installed. Only accepts a single argument.

  CLI Example:

      salt '*' chocolatey.install_webpi <package name>

`salt.modules.chocolatey.` `install_windowsfeatures`(name)

  Instructs Chocolatey to install a Windows Feature via the Deployment Image Servicing and Management tool.

  name
    The name of the feature to be installed. Only accepts a single argument.

  CLI Example:

      salt '*' chocolatey.install_windowsfeatures <package name>

`salt.modules.chocolatey.` `list_`(filter, all_versions=False, pre_versions=False, source=None)

  Instructs Chocolatey to pull a vague package list from the repository.

  filter
    Term used to filter down results. Searches against name/description/tag.
  all_versions
    Display all available package versions in results. Defaults to False.
  pre_versions
    Display pre-release packages in results. Defaults to False.
  source
    Chocolatey repository (directory, share or remote URL feed) the package comes from. Defaults to the official Chocolatey feed.

  CLI Example:

      salt '*' chocolatey.list <filter>
      salt '*' chocolatey.list <filter> all_versions=True

`salt.modules.chocolatey.` `list_webpi`()

  Instructs Chocolatey to pull a full package list from the Microsoft Web PI repository.

  CLI Example:

      salt '*' chocolatey.list_webpi

`salt.modules.chocolatey.` `list_windowsfeatures`()

  Instructs Chocolatey to pull a full package list from the Windows Features list, via the Deployment Image Servicing and Management tool.

  CLI Example:

      salt '*' chocolatey.list_windowsfeatures

`salt.modules.chocolatey.` `uninstall`(name, version=None)

  Instructs Chocolatey to uninstall a package.

  name
    The name of the package to be uninstalled. Only accepts a single argument.
  version
    Uninstalls a specific version of the package. Defaults to latest version installed.

  CLI Example:

      salt '*' chocolatey.uninstall <package name>
      salt '*' chocolatey.uninstall <package name> version=<package version>

`salt.modules.chocolatey.` `update`(name, source=None, pre_versions=False)

  Instructs Chocolatey to update packages on the system.

  name
    The name of the package to update, or "all" to update everything installed on the system.
  source
    Chocolatey repository (directory, share or remote URL feed) the package comes from. Defaults to the official Chocolatey feed.
  pre_versions
    Include pre-release packages in comparison. Defaults to False.

  CLI Example:

      salt "*" chocolatey.update all
      salt "*" chocolatey.update <package name> pre_versions=True

`salt.modules.chocolatey.` `version`(name, check_remote=False, source=None, pre_versions=False)

  Instructs Chocolatey to check an installed package version, and optionally compare it to one available from a remote feed.

  name
    The name of the package to check.
  check_remote
    Get the version number of the latest package from the remote feed. Defaults to False.
  source
    Chocolatey repository (directory, share or remote URL feed) the package comes from. Defaults to the official Chocolatey feed.
  pre_versions
    Include pre-release packages in comparison. Defaults to False.

  CLI Example:

      salt "*" chocolatey.version <package name>
      salt "*" chocolatey.version <package name> check_remote=True

Current Salt release: 0.17.1

#### Previous topic

salt.modules.cassandra

#### Next topic

salt.modules.cmdmod

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd