Método Session.Enumerate

Artículo
06/13/2023

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:

URI del recurso.

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

Objeto ResourceLocator .
Referencia de punto de conexión WS-Addressing tal y como se describe en el estándar de protocolo WS-Management. Para obtener más información sobre la especificación pública del protocolo WS-Management, vea Página de índice de especificaciones de administración.

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