####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 iis_rewrite
   • What iis_rewrite affects
   • Setup requirements
   • Beginning with iis_rewrite
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

This is a module that will install the IIS Rewrite module (2.0) for IIS 7 and above. This module is only intended for use with Windows 2008 and above

##Module Description

This is a module that will install the IIS Rewrite module (2.0) for IIS 7 and above. It is a good companion to our existing iis module (opentable/iis)

##Setup

###What remaster affects

• The installation of the iis rewrite package

###Beginning with iis_rewrite

The module consists of a single class

include iis_rewrite

By default, the package will work out the architecture of the machine and download the correct version of the msi from Microsoft. You can specify a download location other than the official Windows download, as follows:

class { 'iis_rewrite':
  package_source_location => 'http://myhost.com/package231.msi'
}

By using the default params, the package will download using the name format:

rewrite_2.0_rtw_x64.msi

If you wish to download from your own location, we suggest you keep this naming convention. The default location and default package version can be found in params.pp.

##Usage

###Classes and Defined Types

####Class: iis_rewrite The iis_rewrite module primary type, iis_rewrite, guides the installation of the IIS rewrite package

Parameters within iis_rewrite: #####package_source_location The full path to the source msi for the iis rewrite package. Defaults to download directly from Microsoft.

#####download_destination The destination path where the package will be downloaded to on the node. Defaults to C:\Temp

##Reference

###Classes ####Public Classes

• iis_rewrite: Install IIS rewrite package ####Private Classes
• iis_rewrite::install: Ensure that the package is installed

##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.

###Contributing

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