Forge Home

iis

Fork of puppet-iis. Module that will manage IIS for windows server 2008 and above. It will help maintain application pools, sites and virtual applications

8,928 downloads

8,901 latest version

3.1 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 1.0.1 (latest)
  • 1.0.0 (deleted)
released Dec 15th 2016
This version is compatible with:
  • Puppet Enterprise 3.x
  • Puppet 3.x

Start using this module

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

Add this module to your Puppetfile:

mod 'drmarconi-iis', '1.0.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add drmarconi-iis
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install drmarconi-iis --version 1.0.1

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.

Download

Documentation

drmarconi/iis — version 1.0.1 Dec 15th 2016

IIS module for Puppet

FORK OF PUPPET_IIS Module for puppet that can be used to create sites, application pools and virtual applications with IIS 7 and above.

Table of Contents

  1. Overview
  2. [Requirements] (#requirements)
  3. [Types] (#types)
  • [iis_site] (#iis_site)
  • [iis_pool] (#iis_pool)
  • [iis_virtualdirectory] (#iis_virtualdirectory)
  • [iis_application] (#iis_application)

Overview

Create and manage IIS websites, application pools, and virtual applications.

Requirements

  • = Windows 2012

  • IIS installed

Types

iis_site

Enumerate all IIS websites:

  • puppet resource iis_site

Example output for puppet resource iis_site 'Default Web Site'

iis_site { 'Default Web Site':
  ensure   => 'started',
  app_pool => 'DefaultAppPool',
  ip       => '*',
  path     => 'C:\InetPub\WWWRoot',
  port     => '80',
  protocol => 'http',
  ssl      => 'false',
}

iis_site attributes

  • ensure Denotes the presence and state of site. { present, absent, started, stopped } Default: started

  • name (namevar) Web site's name.

  • path Web root for the site. This can be left blank, although IIS won't be able to start the site.

  • app_pool The application pool which should contain the site. Default: DefaultAppPool

  • host_header A host header that should apply to the site. Set to false to maintain no host header.

  • protocol The protocol for the site. Default http

  • ip The IP address for the site to listen on. Default: $::ipaddress

  • port The port for the site to listen on. Default: 80

  • ssl If SSL should be enabled. Default: false

  • state Whether the site should be Started or Stopped. Default: Started

Refresh event

Sending a refresh event to an iis_site type will recycle the web site.

iis_pool

Enumerate all IIS application pools:

  • puppet resource iis_pool

Example output for puppet resource iis_site 'DefaultAppPool'

iis_pool { 'DefaultAppPool':
  ensure        => 'started',
  enable_32_bit => 'false',
  pipeline      => 'Integrated',
  runtime       => 'v4.0',
}

iis_pool attributes

  • ensure Denotes the presence and state of pool. { present, absent, started, stopped } Default: started

  • name (namevar) Application pool's name.

  • enable_32_bit Enable 32-bit applications (boolean). Default: false

  • pipeline The managed pipeline mode for the pool {'Classic', 'Integrated'}.

  • runtime Version of .NET runtime for the pool (float).

  • state Whether the site should be Started or Stopped. Default: Started

Refresh event

Sending a refresh event to an iis_pool type will recycle the application pool.

iis_virtualdirectory

Enumerate all IIS virtual directories:

  • puppet resource iis_virtualdirectory

Example output for puppet resource iis_virtualdirectory 'default'

iis_virtualdirectory { 'default':
  ensure => 'present',
  path   => 'C:\inetpub\wwwroot',
  site   => 'Default Web Site',
}

iis_virtualdirectory attributes

  • path Target directory for the virtual directory.

  • site (Read-only) Web site in which the virtual directory resides. To change sites, remove and re-create virtual directory.

iis_application

Enumerate all IIS applications:

  • puppet resource iis_application

Example output for puppet resource iis_site 'test_app'

iis_application { 'test_app':
  ensure   => 'present',
  app_pool => 'DefaultAppPool',
  path     => 'C:\Temp',
  site     => 'Default Web Site',
}

iis_application attributes

  • app_pool The application pool which should contain the application. Default: DefaultAppPool

  • path Root for the application. This can be left blank, although IIS won't be able to use it.

  • site (Read-only) Web site in which the application resides. To change sites, remove and re-create application.