Resource Type: iis_site

Defined in:
lib/puppet/type/iis_site.rb
Providers:
iisadministration
webadministration

Overview

Allows creation of a new IIS Web Site and configuration of site parameters.

Properties

  • applicationpool

    The name of an ApplicationPool for this IIS Web Site

  • authenticationinfo
  • bindings

    The protocol, address, port, and ssl certificate bindings for a web site.

    For web (http/https) protocols, the bindinginformation value should be in the form of the IPv4/IPv6 address or wildcard *, then the port, then the optional hostname separated by colons: ‘(ip|*)::(hostname)?`

    A protocol value of “http” indicates a binding that uses the HTTP protocol. A value of “https” indicates a binding that uses HTTP over SSL.

    The sslflags parameter accepts integer values from 0 to 3 inclusive.

    • A value of “0” specifies that the secure connection be made using an IP/Port combination. Only one certificate can be bound to a combination of IP address and the port.

    • A value of “1” specifies that the secure connection be made using the port number and the host name obtained by using Server Name Indication (SNI).

    • A value of “2” specifies that the secure connection be made using the centralized SSL certificate store without requiring a Server Name Indicator.

    • A value of “3” specifies that the secure connection be made using the centralized SSL certificate store while requiring Server Name Indicator

  • defaultpage

    Specifies the default page of the site.

  • enabledprotocols

    The protocols enabled for the site. If ‘https’ is specified, ‘http’ is implied. If no value is provided, then this setting is disabled. Can be a comma delimited list of protocols. Valid protocols are: ‘http’, ‘https’, ‘net.pipe’, ‘net.tcp’, ‘net.msmq’, ‘msmq.formatname’.

  • ensure

    Specifies whether a site should be present or absent. If present is specified, the site will be created but left in the default stopped state. If started is specified, then the site will be created as well as started. If stopped is specified, then the site will be created and kept stopped.

    Supported values:
    • stopped
    • started
    • present
    • absent
    • false (alias for: stopped)
    • true (alias for: started)
  • limits

    Configure limits for an IIS Site

  • logflags

    Specifies what W3C fields are logged in the log file. This is only valid when ‘logformat` is set to ’W3C’.

  • logformat

    Specifies the format for the log file. When set to ‘W3C’, used with ‘logflags`

  • loglocaltimerollover

    Use the system's local time to determine for the log file name as well as when the log file is rolled over

    Supported values:
    • true
    • false
  • logpath

    Specifies the physical path to place the log file

  • logperiod

    Specifies how often the log file should rollover

  • logtruncatesize

    Specifies how large the log file should be before truncating it. The value must be in bytes. The value can be any size between '1048576 (1MB)' and '4294967295 (4GB)'.

  • physicalpath

    The physical path to the site directory. This path must be fully qualified.

  • preloadenabled

    Enables loading website automatically without a client request first

    Supported values:
    • true
    • false
  • serviceautostart

    Enables autostart on the specified website

    Supported values:
    • true
    • false
  • serviceautostartprovidername

    Specifies the provider used for service auto start. Used with :serviceautostartprovidertype. The <serviceAutoStartProviders> element specifies a collection of managed assemblies that Windows Process Activation Service (WAS) will load automatically when the startMode attribute of an application pool is set to AlwaysRunning. This collection allows developers to specify assemblies that perform initialization tasks before any HTTP requests are serviced.

    example: serviceautostartprovidername => “MyAutostartProvider” serviceautostartprovidertype => “MyAutostartProvider, MyAutostartProvider, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73”

  • serviceautostartprovidertype

    Specifies the application type for the provider used for service auto start. Used with :serviceautostartprovider

    example: serviceautostartprovidername => “MyAutostartProvider” serviceautostartprovidertype => “MyAutostartProvider, MyAutostartProvider, version=1.0.0.0, Culture=neutral, PublicKeyToken=426f62526f636b73”

Parameters

  • name (namevar)

    The Name of the IIS site. Used for uniqueness. Will set the target to this value if target is unset.

  • provider

    The specific backend to use for this ‘iis_site` resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.