ModuleAction 类

表示配置文件 <modules> 部分中的模块条目。

语法

class ModuleAction : CollectionElement  

方法

此类不包含任何方法。

属性

下表列出了 ModuleAction 类公开的属性。

名称 描述
Name 一个必需的唯一读/写 string 值,包含模块名称。 键属性。
PreCondition 一个读/写 string 值,包含以逗号分隔的值列表,这些值表示要加载的模块的前提条件。 后文的“注解”部分列出了可能的值。
Type 一个指定托管模块类型的读/写 string 值。

子类

此类不包含子类。

注解

此类的实例包含在 ModulesSection 类的 Modules 属性中。

下表列出了 PreCondition 属性的可能值。 integratedModeISAPIMode 设置互斥。 默认为 null

说明
bitness32 IIS 在 32 位工作进程中加载模块。 此设置仅适用于 64 位操作系统。
bitness64 IIS 在 64 位工作进程中加载模块。 此设置仅适用于 64 位操作系统。
integratedMode IIS 仅加载在集成模式下运行的应用程序池的模块。
ISAPIMode IIS 仅加载在 ISAPI 模式下运行的应用程序池的模块。
runtimeVersion IIS 仅加载使用指定 .NET Framework 版本的应用程序池的模块。 若要启用此前置条件,以 vMajorVersion.MinorVersion 格式向字符串“runtimeVersion”追加字符串(例如,“runtimeVersionv2.0”)。
managedHandler 仅当请求映射到托管处理程序时,IIS 才会加载模块。 此设置可以通过防止静态文件对每个请求使用托管模块来优化性能。

示例

以下示例将托管模块添加到根 Web.config 文件。

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the modules section.  
Set oModulesSection = _  
    oWebAdmin.Get("ModulesSection.Path=" & _  
        "'MACHINE/WEBROOT/APPHOST/Default Web Site',Location=''")  
  
' Get the ModuleAction class.  
Set oModuleAction = oWebAdmin.Get( "ModuleAction" )  
  
' Spawn a new instance of the ModuleAction class.  
Set oNewModule = oModuleAction.SpawnInstance_  
  
' Assign values to the new module's Name and Type properties.  
oNewModule.Name = "myNewModule2"  
oNewModule.Type = "System.Web.Profile.ProfileModule2"  
  
' Call the ModulesSection.Add method to add the new module.  
' If the module entry already exists, the error "Cannot create a file  
' when that file already exists." will be displayed.  
oModulesSection.Add "Modules", oNewModule  
  
' Alert user when done.  
WScript.Echo "Done!"  
  

继承层次结构

CollectionElement

ModuleAction

要求

类型 描述
客户端 - IIS 7.0(在 Windows Vista 上)
- IIS 7.5(在 Windows 7 上)
- IIS 8.0(在 Windows 8 上)
- IIS 10.0(在 Windows 10 上)
服务器 - IIS 7.0(在 Windows Server 2008 上)
- IIS 7.5(在 Windows Server 2008 R2 上)
- IIS 8.0(在 Windows Server 2012 上)
- IIS 8.5(在 Windows Server 2012 R2 上)
- IIS 10.0(在 Windows Server 2016 上)
产品 - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件 WebAdministration.mof

另请参阅

CollectionElement 类
GlobalModuleElement 类
GlobalModulesSection 类
ModulesSection 类