ModuleAction-Klasse

Artikel
03/28/2024

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

Freigeben über