puppet-windowsfeature

####Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with windowsfeature
   • What windowsfeature affects
   • Setup requirements
   • Beginning with windowfeature
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

##Overview

The windowsfeature module is a small define that allows you to install/remove windows features.

##Module Description

The windowsfeature module introduces a small define windowsfeature that uses the ServerManager API that comes with Windows Server 2008 R2 and Windows Server 2012 to add/remove Windows features.

For a list of the windows features you can install, please visit this technet article

##Setup ###What download_file affects

• Installs windows features (and optionally corresponding tools)

###Setup Requirements

• windowsfeature makes use of Powershell so you will need to have at least version 2.0 installed in order to use this module.

##Begining

To install a single windows feature such as dotnet 3.5:

windowsfeature { 'NET-Framework-Core': }

To install several windows features as part of a large application such IIS:

windowsfeature { 'IIS':
  feature_name => [
    'Web-Server',
    'Web-WebServer',
    'Web-Asp-Net45',
    'Web-ISAPI-Ext',
    'Web-ISAPI-Filter',
    'NET-Framework-45-ASPNET',
    'WAS-NET-Environment',
    'Web-Http-Redirect',
    'Web-Filtering',
    'Web-Mgmt-Console',
    'Web-Mgmt-Tools'
  ]
}

To install any associated management tools:

windowsfeature { 'Web-WebServer':
  installmanagementtools => true
}

To install all subfeatures:

windowsfeature { 'Web-WebServer':
  installsubfeatures => true
}

To install a feature and that requires a restart:

windowsfeature {'RDS-RD-Server':
  restart => 'true'
}

##Usage

###Classes and Defined Types

####Defined Type: windowsfeature

Parameters within windowsfeature: #####ensure Controls if the Windows feature is installed. Can be present or absent.

#####feature_name Provides the name of the feature that you want to install if this differs from the resource title.

#####installmanagementtools Specifies that all applicable management tools should be installed for the given feature. Defaults to false

#####installsubfeatures Specifies that all subordinate features of this feature are also installed. Defaults to false

#####restart Specifies that when installing the windows feature it should perform and restart automatically.

#####source Specifies the location of the feature files. This may be a network location or a path to the specific wim file.

#####timeout Specifies the timeout in seconds for the feature installation. Use this if the feature takes longer than 300 seconds to complete.

##Reference

###Defined Types ####Public Types

• windowsfeature: Install or remove a given windows feature

##Limitations

This module is tested on the following platforms:

• Windows 2008
• Windows 2008 R2
• Windows 2012
• Windows 2012 R2

It is tested with the OSS version of Puppet only.

###Known issues

• Specifying installmanagementtools and/or installsubfeatures when a feature is already installed will not install said management tools or sub features.

###Contributing

Please read CONTRIBUTING.md for full details on contributing to this project.

##2015-05-01 - Release 1.1.0 ###Summary

A few small features in this release. First release under the new puppet-community namespace

####Features

• added new timeout parameter for features that take longer than the default 300 seconds to complete.
• added support for kernelversion 10 for people deploying on Windows 10

##2014-10-13 - Release 1.0.0 ###Summary

Finally bumping to 1.0.

####Features

• adding source paramater
• updating documentation

##2014-08-14 - Release 0.2.0 ###Summary

Small release to bump stdlib dependency to be 4.0 minimum

##2014-04-14 - Release 0.1.2 ###Summary

This release fixes some minor idempotency and platform specific bugs

####Bugfixes

• fixing idempotency
• fixed installation on windows 2008

##2014-04-04 - Release 0.1.1 ###Summary

This release adds support for windows 2012

##2014-04-04 - Release 0.1.0 ###Summary

This release adding some new parameters to install sub features and management tools

####Features

• added includemanagementtools and includesubfeatures parameters

####Bugfixes

• limit module usage for Windows 2008 R2 and newer versions of Windows

##2014-03-30 - Release 0.0.3 ###Summary

This release replaces all the hardcoded powershell with uses of the joshcopper/powershell provider

##2014-01-19 - Release 0.0.2 ###Summary

Initial version.