Forge Home


This module allows for the setup and configuration management of Windows Services.


37,441 latest version

4.4 quality score

Version information

  • 0.0.10 (latest)
  • 0.0.9
  • 0.0.8
  • 0.0.7
  • 0.0.6
  • 0.0.5
  • 0.0.4
  • 0.0.2
  • 0.0.1
released Aug 29th 2017
This version is compatible with:
  • Windows

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'ocastle-win_service', '0.0.10'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add ocastle-win_service
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install ocastle-win_service --version 0.0.10

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



ocastle/win_service — version 0.0.10 Aug 29th 2017


Custom Type Provider for the creation/configuration of Windows Services. Currently this determins services installed to a Windows Host using the ruby gem 'win32-service'. All updates to service configurations are facilitated with the sc.exe within Windows SCM.

The module is avialable from:


  • Windows
  • Puppet installed via the Windows Installer
  • 'win32-service' ruby gem

Example Usage

#Sample usage with minimum values given.

      win_service { 'defragsvc':
        ensure             => 'present',
        display_name       => 'Disk Defragmeter',
        binary_path_name   => 'C:\Windows\system32\svchost.exe -k defragsvc',
        service_start_name => 'localSystem',
        start_type         => 'demand',

#Sample usage when using an account other than localsystem.

      win_service { 'defragsvc':
        ensure                 => 'present',
        display_name           => 'Disk Defragmenter',
        binary_path_name       => 'C:\Windows\system32\svchost.exe -k defragsvc',
        service_start_name     => 'Your-Account-Name',
        password               => 'password',
        start_type             => 'demand',
        password_checksum_path => 'Path\to\put\md5\checksum',