ModuleAction-Klasse

Stellt einen Moduleintrag im <modules> Abschnitt einer Konfigurationsdatei dar.

Syntax

class ModuleAction : CollectionElement  

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der ModuleAction-Klasse verfügbar gemacht werden.

Name	Beschreibung
Name	Ein erforderlicher eindeutiger Lese-/Schreibwert string, der den Namen des Moduls enthält. Die Schlüsseleigenschaft.
PreCondition	Ein Lese-/Schreibwert string, der eine durch Trennzeichen getrennte Liste von Werten enthält, die Voraussetzungen für das zu ladende Modul darstellen. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
Type	Ein Lese-/Schreibwert string, der den Typ eines verwalteten Moduls angibt.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Instanzen dieser Klasse sind in der Modules Eigenschaft der ModulesSection-Klasse enthalten.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die PreCondition Eigenschaft angezeigt. Die Einstellungen integratedMode und ISAPIMode schließen sich gegenseitig aus. Der Standardwert ist null.

Wert	Beschreibung
bitness32	IIS lädt das Modul in einem 32-Bit-Arbeitsprozess. Diese Einstellung gilt nur für 64-Bit-Betriebssysteme.
bitness64	IIS lädt das Modul in einem 64-Bit-Arbeitsprozess. Diese Einstellung gilt nur für 64-Bit-Betriebssysteme.
integratedMode	IIS lädt das Modul nur für Anwendungspools, die im integrierten Modus ausgeführt werden.
ISAPIMode	IIS lädt das Modul nur für Anwendungspools, die im ISAPI-Modus ausgeführt werden.
runtimeVersion	IIS lädt das Modul nur für Anwendungspools, die die angegebene .NET Framework-Version verwenden. Um diese Voraussetzung zu aktivieren, fügen Sie eine Zeichenfolge im Format vMajorVersionan.MinorVersion zur Zeichenfolge „runtimeVersion“ (z. B. „runtimeVersionv2.0“).
managedHandler	IIS lädt das Modul nur, wenn die Anforderung einem verwalteten Handler zugeordnet ist. Diese Einstellung kann die Leistung optimieren, indem statische Dateien für jede Anforderung keine verwalteten Module verwenden.

Beispiel

Im folgenden Beispiel wird der Stammdatei Web.config ein verwaltetes Modul hinzugefügt.

' 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!"  
  

Vererbungshierarchie

CollectionElement

ModuleAction

Anforderungen

type	Beschreibung
Client	- IIS 7.0 unter Windows Vista IIS 7.5 unter Windows 7 IIS 8.0 unter Windows 8 IIS 10.0 unter Windows 10
Server	IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 IIS 8.0 auf Windows Server 2012 - IIS 8.5 unter Windows Server 2012 R2 IIS 10.0 auf Windows Server 2016
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

CollectionElement-Klasse
GlobalModuleElement-Klasse
GlobalModulesSection-Klasse
ModulesSection-Klasse