Compartir a través de


Método Session.Enumerate

Enumera una tabla, una colección de datos o un recurso de registro. Para crear una consulta, incluya un parámetro de filtro y un parámetro dialecto en una enumeración. También puede usar un objeto ResourceLocator para crear consultas. Para obtener más información, vea Enumerar o enumerar todas las instancias de un recurso.

Sintaxis

Session.Enumerate( _
  ByVal resourceUri, _
  [ ByVal filter ], _
  [ ByVal dialect ], _
  [ ByVal flags ] _
)

Parámetros

resourceUri [in]

Identificador del recurso que se va a recuperar.

Este parámetro puede contener una de las siguientes opciones:

filter [in, optional]

Filtro que define qué elementos del recurso devuelve la enumeración . Cuando se enumera el recurso, solo se devuelven los elementos que coinciden con los criterios de filtro. La inclusión de un parámetro de filtro y un parámetro dialecto en una enumeración convierte la enumeración en una consulta. Para obtener un ejemplo, consulte Consulta para instancias específicas de un recurso.

Si tiene un objeto ResourceLocator para el parámetro resourceURI , no se debe usar este parámetro.

dialecto [in, opcional]

Idioma utilizado por el filtro. WQL, un subconjunto de SQL usado por WMI, es el único lenguaje admitido.

Si tiene un objeto ResourceLocator para el parámetro resourceURI , no se debe usar este parámetro.

flags [in, optional]

Parámetro que debe contener una marca en la enumeración __WSManEnumFlags . Para obtener más información, vea Constantes de enumeración.

Valor devuelto

Objeto Enumerador que contiene los resultados de la enumeración.

Observaciones

Para obtener más información sobre cómo limitar las llamadas de red durante una enumeración, consulte la propiedad BatchItems .

Tenga en cuenta que si las marcas incluyen las constantes de enumeraciónWSManFlagHierarchyDeepBasePropsOnly o WSManFlagHierarchyShallow , el servicio de administración remota de Windows devuelve el código de error ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED.

Si se especifica un filtro, debe ser un documento válido con respecto al esquema del recurso. El parámetro dialecto es opcional. Sin embargo, si la cadena de filtro comienza por <, pero no es un fragmento XML, incluya el parámetro dialecto o establezca la marca WSManFlagNonXmlText en el parámetro flags . Para obtener más información, vea Constantes de enumeración.

El método de C++ correspondiente es IWSManSession::Enumerate.

Ejemplos

En el siguiente ejemplo de código vbScript se enumeran las instancias de Win32_LogicalDisk en un equipo remoto especificado por el nombre de dominio completo (servername.domain.com). Tenga en cuenta que liberar el objeto de enumeración borra las solicitudes de enumeración pendientes. La subrutina DisplayOutput usa el archivo de transformación XML de la herramienta de línea de comandos winrm (WsmTxt.xsl) para generar los datos en un formulario tabular.

Const RemoteComputer = "servername.domain.com"
Set objWsman = CreateObject( "WSMan.Automation" )

Set objSession = objWsman.CreateSession( "https://" & REMOTECOMPUTER )

strResource = "http://schemas.microsoft.com/wbem/wsman/1/" &_
              "wmi/root/cimv2/Win32_LogicalDisk"

Set objResultSet = objSession.Enumerate( strResource )

While Not objResultSet.AtEndOfStream
 
 DisplayOutput( objResultSet.ReadItem ) 

Wend

'****************************************************
' Displays WinRM XML message using built-in XSL
'****************************************************
Sub DisplayOutput( strWinRMXml )
    Dim xmlFile, xslFile
    Set xmlFile = CreateObject( "MSXml2.DOMDocument.3.0" ) 
    Set xslFile = CreateObject( "MSXml2.DOMDocument.3.0" )
    xmlFile.LoadXml( strWinRMXml )
    xslFile.Load( "WsmTxt.xsl" )
    Wscript.Echo xmlFile.TransformNode( xslFile ) 
End Sub

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Encabezado
WSManDisp.h
IDL
WSManDisp.idl
Biblioteca
WSManDisp.tlb
Archivo DLL
WSMAuto.dll

Consulte también

Sesión

Consulta de instancias específicas de un recurso

BatchItems

ResourceLocator