Agregar módulos <add> element for for Internet Information Services (IIS) 7;

Información general

El elemento <add> de la colección <modules> agrega un módulo a la lista de módulos de Internet Information Services (IIS) 7.

Compatibilidad

Versión	Notas
IIS 10.0	El elemento <add> no se modificó en IIS 10.0.
IIS 8.5	El elemento <add> no se modificó en IIS 8.5.
IIS 8.0	El elemento <add> no se modificó en IIS 8.0.
IIS 7.5	El elemento <add> no se modificó en IIS 7.5.
IIS 7.0	El elemento <add> de la colección <modules> se introdujo en IIS 7.0.
IIS 6,0	N/D

Configuración

El elemento <add> de la colección <modules> se incluye en la instalación predeterminada de IIS 7.

Procedimientos

Adición de un módulo administrado a una aplicación

1. Abra el Administrador de Internet Information Services (IIS):

   • Si usa Windows Server 2012 o Windows Server 2012 R2:

     • En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).

   • Si usa Windows 8 o Windows 8.1:

     • Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
     • En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

   • Si usa Windows Server 2008 o Windows Server 2008 R2:

     • En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).

   • Si usa Windows Vista o Windows 7:

     • En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
     • Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

2. En el panel Conexiones, expanda el nombre del servidor, expanda Sitios y, a continuación, vaya al sitio web o la aplicación a la que desea agregar un módulo administrado.

3. En el panel Inicio, haga doble clic en Módulos.
   

4. En el panel Acciones, haga clic en Agregar módulo administrado.

5. En el cuadro de diálogo Agregar módulo administrado, escriba el nombre del módulo administrado en el cuadro Nombre y, a continuación, escriba o seleccione el tipo completo de .NET Framework del módulo en el cuadro Tipo.

6. Seleccione la opción Invocar solo para solicitudes a aplicaciones ASP.NET o controladores administrados si desea que el módulo responda solo a las solicitudes administradas.
   

7. Haga clic en OK.

Configuración

Atributos

Atributo	Descripción
name	Atributo de cadena necesario. Especifica el nombre único de un módulo administrado en el servidor web.
preCondition	Atributo de cadena opcional. Especifica las condiciones en las que se ejecutará el módulo. El atributo preCondition puede tener uno o varios de los siguientes valores posibles. Si especifica más de un valor, separe los valores con una coma (,). Valor Descripción bitness32 Especifique el valor de bitness32 cuando el módulo es un archivo de .dll de 32 bits. IIS debe cargar el controlador solo para los procesos de trabajo que se ejecutan en modo WOW64 (simulación de 32 bits) en un sistema operativo de 64 bits. bitness64 Especifique el valor de bitness64 cuando el módulo es un archivo .dll de 64 bits. IIS debe cargar el controlador solo para los procesos de trabajo que se ejecutan en modo de 64 bits. integratedMode Especifique el valor integratedMode cuando el módulo solo debe responder a las solicitudes de los grupos de aplicaciones configurados para usar la canalización integrada de procesamiento de solicitudes. ISAPIMode Especifique el valor ISAPIMode cuando el módulo solo debe responder a las solicitudes de los grupos de aplicaciones que están configurados para usar el modo clásico. managedHandler Especifique el valor managedHandler cuando el módulo debe procesar solicitudes solo para recursos administrados, como archivos .aspx, y no debe responder a solicitudes de recursos no administrados, como archivos .html. runtimeVersionv1.1 Especifique el valor runtimeVersionv1.1 cuando el módulo solo debe responder a las solicitudes de los grupos de aplicaciones configurados para usar .NET Framework versión 1.1. runtimeVersionv2.0 Especifique el valor runtimeVersionv2.0 cuando el módulo solo debe responder a las solicitudes de los grupos de aplicaciones configurados para usar .NET Framework versión 2.0. runtimeVersionv4.0 Especifique el valor runtimeVersionv4.0 cuando el módulo solo debe responder a las solicitudes de los grupos de aplicaciones configurados para usar .NET Framework versión 4.0.
type	Atributo de cadena opcional. Especifica el tipo administrado de un módulo administrado. El atributo type no se aplica a los módulos nativos.

Elementos secundarios

Ninguno.

Ejemplo de configuración

En el ejemplo se configura un módulo para una aplicación web que se ejecuta en modo integrado de IIS 7.

<configuration>
   <system.webServer>
      <modules>
         <add name="Header" type="Contoso.ShoppingCart.Header"/>
      </modules>
   </system.webServer>
</configuration>

Código de ejemplo

Nota:

Los ejemplos de este documento ilustran el uso de un ensamblado de código administrado que se ha almacenado en la caché global de ensamblados (GAC) de .NET. Antes de usar el código de estos ejemplos para implementar sus propios ensamblados, debe recuperar la información del ensamblado de GAC. Para ello, siga estos pasos:

• En el Explorador de Windows, abra la ruta de acceso C:\Windows\assembly, donde C: es la unidad del sistema operativo.
• Busque el ensamblado.
• Haga clic con el botón secundario en el ensamblado y haga clic en Propiedades.
• Copie el valor de Cultura; por ejemplo: Neutro.
• Copie el número de Versión; por ejemplo: 1.0.0.0.
• Copie el valor de Token de clave pública; por ejemplo: 426f62526f636b73.
• Haga clic en Cancelar.

En los siguientes ejemplos de código se habilita un módulo administrado para un sitio web denominado Contoso. La propiedad name define el nombre CartHeader para el módulo, la propiedad type define el tipo administrado para el módulo, la propiedad preCondition define que IIS invoca el módulo solo para las solicitudes administradas.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/modules /+"[name='CartHeader',type='Contoso.ShoppingCart.Header',preCondition='managedHandler']"

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetWebConfiguration("Contoso");
         ConfigurationSection modulesSection = config.GetSection("system.webServer/modules");
         ConfigurationElementCollection modulesCollection = modulesSection.GetCollection();

         ConfigurationElement addElement = modulesCollection.CreateElement("add");
         addElement["name"] = @"CartHeader";
         addElement["type"] = @"Contoso.ShoppingCart.Header";
         addElement["preCondition"] = @"managedHandler";
         modulesCollection.Add(addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetWebConfiguration("Contoso")
      Dim modulesSection As ConfigurationSection = config.GetSection("system.webServer/modules")
      Dim modulesCollection As ConfigurationElementCollection = modulesSection.GetCollection

      Dim addElement As ConfigurationElement = modulesCollection.CreateElement("add")
      addElement("name") = "CartHeader"
      addElement("type") = "Contoso.ShoppingCart.Header"
      addElement("preCondition") = "managedHandler"
      modulesCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso";
var modulesSection = adminManager.GetAdminSection("system.webServer/modules", "MACHINE/WEBROOT/APPHOST/Contoso");
var modulesCollection = modulesSection.Collection;

var addElement = modulesCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "CartHeader";
addElement.Properties.Item("type").Value = "Contoso.ShoppingCart.Header";
addElement.Properties.Item("preCondition").Value = "managedHandler";
modulesCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso"
Set modulesSection = adminManager.GetAdminSection("system.webServer/modules", "MACHINE/WEBROOT/APPHOST/Contoso")
Set modulesCollection = modulesSection.Collection

Set addElement = modulesCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "CartHeader"
addElement.Properties.Item("type").Value = "Contoso.ShoppingCart.Header"
addElement.Properties.Item("preCondition").Value = "managedHandler"
modulesCollection.AddElement addElement

adminManager.CommitChanges()