Método ConfigurationSectionWithCollection.Get

Recupera el miembro especificado de una colección de una sección de configuración.

Sintaxis

ConfigurationSectionWithCollection.Get   
   CollectionName,   
   ElementIdentifier,   
   CollectionElement;  

ConfigurationSectionWithCollection.Get   
CollectionName,   
ElementIdentifier,   
CollectionElement  

Parámetros

Name	Descripción
CollectionName	Un valor string que contiene el nombre de la colección que se recuperará (por ejemplo, "Modules"). El nombre de la colección puede representar una colección anidada y puede usar índices. El índice puede ser entero de base cero o una cadena (por ejemplo, [9] o "KeyProperty='Value'"). Para obtener más información, vea la sección Comentarios. Nota: CollectionName es el nombre de la sección tal como se encuentra en el archivo de configuración, no el nombre de la clase WMI correspondiente (por ejemplo, "Modules", no "ModulesSection").
ElementIdentifier	Un valor string que especifica una propiedad de clave y un valor del elemento de colección que se va a recuperar. La cadena debe tener el formato "KeyProperty1='Value1',KeyProperty2='Value2',..." (por ejemplo, "Name='RoleManager'").
CollectionElement	Una variable del objeto CollectionElement en la que se colocará el elemento de colección recuperado (por ejemplo, oModule).

Valor devuelto

void.

Comentarios

Este método es útil cuando solo quiere recuperar un miembro de una colección.

En los ejemplos siguientes se muestran las variaciones de sintaxis del parámetro CollectionName.

La sintaxis siguiente muestra un parámetro CollectionName que usa un índice "KeyProperty='Value'" basado en cadenas y especifica una colección anidada:

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

Puede especificar el mismo valor con un índice basado en cero:

traceFailedRequests[1].TraceAreas.TraceAreas

Si el parámetro ElementIdentifier es "provider='ASP'" y la variable CollectionElement de salida es oTraceAreaElement, la llamada completa al método Get podría ser similar a la siguiente sintaxis:

oSection.Get _

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

"provider='ASP'", oTraceAreaElement

La sintaxis siguiente muestra la llamada completa con un índice basado en cero:

oSection.Get _

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

"provider='ASP'", oTraceAreaElement

Ejemplo

En el ejemplo siguiente se recupera el nombre y el tipo del módulo RoleManager de la sección <modules> del archivo 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  
  

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Server	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Archivo MOF	WebAdministration.mof

Consulte también

Clase CollectionElement
Clase ConfigurationSectionWithCollection
Clase ModuleAction
Clase ModulesSection
Clase TraceAreaElement
Clase TraceFailedRequestsSection
Clase TraceUrl
Clase TraceUrlAreaSettings