Classe ModuleAction

Article
03/25/2024

Représente une entrée de module dans la section <modules> d’un fichier de configuration.

Syntaxe

class ModuleAction : CollectionElement

Méthodes

Cette classe ne contient pas de méthodes.

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe ModuleAction.

Nom	Description
`Name`	Une valeur en lecture/écriture `string` unique requise qui contient le nom du module. La propriété clé.
`PreCondition`	Une valeur en lecture/écriture `string` qui contient une liste séparée par des virgules de valeurs qui représentent les conditions préalables au chargement du module. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
`Type`	Une valeur en lecture/écriture `string` qui spécifie le type d’un module managé.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Les instances de cette classe sont contenues dans la propriété Modules de la classe ModulesSection.

Le tableau suivant répertorie les valeurs possibles pour la propriété PreCondition. Les paramètres integratedMode et ISAPIMode s’excluent mutuellement. Par défaut, il s’agit de null.

Valeur	Description
`bitness32`	IIS charge le module dans un processus de travail 32 bits. Ce paramètre s’applique uniquement aux systèmes d’exploitation 64 bits.
`bitness64`	IIS charge le module dans un processus de travail 64 bits. Ce paramètre s’applique uniquement aux systèmes d’exploitation 64 bits.
`integratedMode`	IIS charge le module uniquement pour les pools d’applications qui s’exécutent en mode Intégré.
`ISAPIMode`	IIS charge le module uniquement pour les pools d’applications qui s’exécutent en mode ISAPI.
`runtimeVersion`	IIS charge le module uniquement pour les pools d’applications qui utilisent la version spécifiée de .NET Framework. Pour activer cette condition préalable, ajoutez une chaîne au format vMajorVersion.MinorVersion à la chaîne « runtimeVersion » (par exemple, « runtimeVersionv2.0 »).
`managedHandler`	IIS charge le module uniquement si la requête est mappée à un gestionnaire managé. Ce paramètre peut optimiser les performances en empêchant les fichiers statiques d’utiliser des modules managés pour chaque requête.

Exemple

L’exemple suivant ajoute un module managé au fichier Web.config racine.

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

Hiérarchie d'héritage

CollectionElement

ModuleAction

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

Classe CollectionElement
Classe GlobalModuleElement
Classe GlobalModulesSection
Classe ModulesSection

Partager via