IIS 7.0: modules Element (IIS Settings Schema)

Configures modules for IIS Manager. The <modules> list specifies the features that are available in IIS Manager when a user is connected to a site or an application.

configuration Element [IIS 7 Settings Schema]
  IIS 7.0: modules Element (IIS Settings Schema)
<modules>
   <add... />
   <clear />
   <remove... />
</modules>
Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

None.

Child Elements

Element

Description

add

Optional element.

Adds a module to the collection of modules for IIS Manager.

clear

Optional element.

Removes all references to modules from the parent modules collection.

remove

Optional element.

Removes a reference to a module from the collection of modules for IIS Manager.

Parent Elements

Element

Description

configuration

Specifies the root element in every configuration file that is used by IIS 7.

Remarks

The <moduleProviders> collection is the master list of all IIS Manager modules that are available on the server. Each module in the <moduleProviders> list must have a friendly name and an assembly-qualified type name. The <modules> collection is a list that specifies which of the server modules (that are registered in the <moduleProviders> collection) are available for site and application connections in IIS Manager.

NoteNote:

A module that you add to the <modules> collection must first be added to the <moduleProviders> collection.

If you want to configure modules for site connections in IIS Manager, you must configure the <modules> collection in the root Administration.config file. If you want to configure modules for application connections in IIS Manager, you must configure the <modules> collection in an Administration.config file in a parent site's directory.

Use the path attribute of the <location> element to specify the path to which a <modules> collection applies. For example, when the path attribute is "." (as shown in the default configuration excerpt below), the <modules> collection applies to all sites and applications. You can configure another <location> element and <modules> collection in Administration.config to specify settings for a specific site, such as the Default Web Site. For more information, see the example section in this topic.

Default Configuration

The following default <modules> element is configured in the root Administration.config file in IIS 7 when the all the role services are installed.

<!-- For all Sites -->
    <location path=".">
        <modules>
            <add name="WebObjects" />
            <add name="Modules" />
            <add name="Handlers" />
            <add name="ExtensionRestrictions" />
            <add name="Authentication" />
            <add name="AnonymousAuthentication" />
            <add name="BasicAuthentication" />
            <add name="ActiveDirectoryAuthentication" />
            <add name="WindowsAuthentication" />
            <add name="DigestAuthentication" />
            <add name="Authorization" />
            <add name="IPRestrictions" />
            <add name="Ssl" />
            <add name="Certificates" />
            <add name="DefaultDocument" />
            <add name="DirectoryBrowse" />
            <add name="Compression" />
            <add name="CustomErrors" />
            <add name="HttpHeaders" />
            <add name="NativeCaching" />
            <add name="HttpRedirect" />
            <add name="MimeTypes" />
            <add name="ClassicAsp" />
            <add name="Cgi" />
            <add name="FailureTracing" />
            <add name="WorkerProcesses" />
            <add name="IsapiFilters" />
            <add name="Administrators" />
            <add name="Service" />
            <add name="Delegation" />
            <add name="FormsAuthentication" />
            <add name="Impersonation" />
            <add name="TrustLevels" />
            <add name="Roles" />
            <add name="Users" />
            <add name="WebForms" />
            <add name="AppSettings" />
            <add name="ConnectionStrings" />
            <add name="Globalization" />
            <add name="Compilation" />
            <add name="MachineKey" />
            <add name="ProviderConfiguration" />
            <add name="Profile" />
            <add name="SessionState" />
            <add name="SmtpMail" />
        </modules>
    </location>
Example

The following code example shows how to remove the Cgi module from the Default Web Site. When users connect to the Default Web Site by using IIS Manager, they will not see the CGI feature in the user interface (UI).

<location path="Default Web Site">
   <modules>
      <remove name="Cgi" />
   </modules>
</location>
Element Information

Configuration locations

Root Administration.config

Site level Administration.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

See Also

Reference

Page view tracker