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>
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. |
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.
Note: |
|---|
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>
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>
Configuration locations | Root Administration.config Site level Administration.config |
Requirements | Microsoft Internet Information Services (IIS) version 7.0 |
Reference