This module acts as a pack of the Puppet Forge's best Windows content. Installing puppetlabs-windows will install a variety of great modules from a diverse group of module authors, including Puppet Labs. Many are contributed by our community, reviewed and recommended by Puppet Labs as Puppet Approved modules. Several core modules are provided through our Puppet Supported program.
This guide assumes that you have downloaded and installed Puppet Enterprise on your Windows server and that you've connected its Puppet agent to a Puppet Enterprise master.
- Learn more on installing the Puppet Enterprise agent onto a Windows server.
- Don't have a PE master? Try the Learning Puppet VM for evaluation purposes.
Once installed, start by installing the windows module pack onto your PE master (like the Learning VM) by running puppet module install puppetlabs-windows
from the command-line. You should see the Puppet module tool installing multiple modules from the Puppet Forge. Learn more about installing modules.
Now, you can start using individual modules from this pack to solve a problem. To do this, you'll want to browse the documentation for an individual module listed below. Equipped with details on interacting with individual module capabilities, you may want to write your own module or directly assign work to your Windows machine from the Puppet Enterprise console.
These are the modules available in the puppetlabs-windows pack. Full documentation for each module can be found by following links to individual module pages. By installing puppetlabs-windows, you will install recommended versions of the entire set of Puppet modules.
Take note that only the modules by Puppet Labs are supported with Puppet Enterprise. The rest have been reviewed and recommended by Puppet Labs but are not eligible for commercial support.
Use Puppet on Windows to:
- Read, create and write registry keys with puppetlabs-registry.
- Interact with PowerShell through the Puppet DSL with puppetlabs-powershell.
- Reboot Windows as part of management as necessary through puppetlabs-reboot.
- Enforce fine-grained access control permissions using puppetlabs-acl.
- Install or remove Windows features with opentable-windowsfeature.
- Download files for use during management via opentable-download_file.
- Build IIS sites and virtual applications with opentable-iis.
- Install packages with chocolatey-chocolatey.
- Soon, create and manage Microsoft SQL including databases, users and grants with the puppetlabs-sqlserver module (installed separately).
You can find even more great modules by searching for windows. Here are a few examples from the Puppet community.
- liamjbennett-windows_autoupdate
- liamjbennett-windows_eventlog
- opentable-sslcertificate
- counsyl-windows
- ceritsc-chocolatey_sw
- jriviere-windows_ad
- trlinkin-domain_membership
These modules are not part of this pack nor are they Puppet Approved or Puppet Supported. But, every Forge module now offers quality and community ratings to help you choose the best module for your need.