Méthode ConfigurationSectionWithCollection.Get

Article
03/19/2024

Récupère le membre spécifié d'une collection à partir d'une section de configuration.

Syntaxe

ConfigurationSectionWithCollection.Get   
   CollectionName,   
   ElementIdentifier,   
   CollectionElement;

ConfigurationSectionWithCollection.Get   
CollectionName,   
ElementIdentifier,   
CollectionElement

Paramètres

Nom	Description
`CollectionName`	Valeur `string` qui contient le nom de la collection qui sera récupérée (par exemple, « Modules »). Le nom de la collection peut représenter une collection imbriquée et peut utiliser des index. L’index peut être un index entier de base zéro ou une chaîne (par exemple, [9] ou «KeyProperty='Value' »). Pour plus d'informations, consultez la section Notes. Remarque :`CollectionName` est le nom de la section tel qu’il se trouve dans le fichier de configuration, et non le nom de la classe WMI correspondante (par exemple, « Modules », et non « ModulesSection »).
`ElementIdentifier`	Valeur `string` qui spécifie une propriété clé et une valeur de l’élément de collection à récupérer. La chaîne doit être au format «KeyProperty1='Value1',KeyProperty2='Value2',... » (par exemple, « Name='RoleManager' »).
`CollectionElement`	Variable objet CollectionElement dans laquelle l’élément de collection récupéré sera placé (par exemple, `oModule`).

Valeur de retour

void.

Notes

Cette méthode est utile lorsque vous souhaitez récupérer un seul membre d’une collection.

Les exemples suivants illustrent des variations de syntaxe pour le paramètre CollectionName.

La syntaxe suivante montre un paramètre CollectionName qui utilise un index «KeyProperty='Value' » basé sur une chaîne et spécifie une collection imbriquée :

traceFailedRequests[path='Rule_2'].TraceAreas.TraceAreas

Vous pouvez spécifier la même valeur avec un index de base zéro :

traceFailedRequests[1].TraceAreas.TraceAreas

Si le paramètre ElementIdentifier est "provider='ASP'" et la variable de sortie CollectionElement est oTraceAreaElement, l’appel complet à la méthode Get peut ressembler à la syntaxe suivante :

oSection.Get _

"traceFailedRequests[path='Rule_2'].TraceAreas.TraceAreas", _

"provider='ASP'", oTraceAreaElement

La syntaxe suivante montre l’appel complet avec un index de base zéro :

oSection.Get _

"traceFailedRequests[1].TraceAreas.TraceAreas", _

"provider='ASP'", oTraceAreaElement

Exemple

L’exemple suivant récupère le nom et le type du module RoleManager à partir de la section <modules> du fichier ApplicationHost.config.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' First, get the <modules> section by using the inherited   
' WMI Get method on the WMI class name of the section  
' (that is, "ModulesSection").  
Set oSection = oWebAdmin.Get( _  
    "ModulesSection.Path='MACHINE/WEBROOT/APPHOST/'," & _  
    "Location=''")  
  
' Display the path.   
WScript.Echo "Path: " & oSection.Path_.RelPath  
  
' Retrieve the RoleManager member of the collection.  
' This is the ConfigurationSectionWithCollection.Get method,  
' so use the collection name found in the configuration file  
' (that is, "Modules").  
oSection.Get "Modules", "Name='RoleManager'", oModule  
  
' Display the module name and type.  
WScript.Echo "Module Name: " & oModule.Name  
WScript.Echo "Module Type: " & oModule.Type  
  
' Output:  
' Path: ModulesSection.Location="",Path="MACHINE/WEBROOT/APPHOST/"  
' Module Name: RoleManager  
' Module Type: System.Web.Security.RoleManagerModule

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 ConfigurationSectionWithCollection
Classe ModuleAction
Classe ModulesSection
Classe TraceAreaElement
Classe TraceFailedRequestsSection
Classe TraceUrl
Classe TraceUrlAreaSettings

Partager via