Session.Enumerate 方法

  • 项目

枚举表、数据收集或日志资源。 若要创建查询，请在枚举中包含 筛选器 参数和 方言 参数。 还可以使用 ResourceLocator 对象创建查询。 有关详细信息，请参阅 枚举或列出资源的所有实例。

语法

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

参数

resourceUri [in]

要检索的资源的标识符。

此参数可以包含以下项之一：

filter [in， optional]

一个筛选器，用于定义枚举返回的资源中的项。 枚举资源时，仅返回与筛选条件匹配的项。 在枚举中包含 筛选器 参数和 方言 参数会将枚举转换为查询。 有关示例，请参阅 查询资源的特定实例。

如果 resourceURI 参数有 ResourceLocator 对象，则不应使用此参数。

方言 [in， 可选]

筛选器使用的语言。 WQL 是 WMI 使用的 SQL 的子集，是唯一支持的语言。

如果 resourceURI 参数有 ResourceLocator 对象，则不应使用此参数。

flags [in， optional]

一个参数，该参数必须包含 __WSManEnumFlags 枚举中的标志。 有关详细信息，请参阅 枚举常量。

返回值

一个 Enumerator 对象，其中包含枚举的结果。

备注

有关在枚举期间限制网络调用的详细信息，请参阅 BatchItems 属性。

请注意，如果标志包含 枚举常量WSManFlagHierarchyDeepBasePropsOnly 或 WSManFlagHierarchyShallow ，则 Windows 远程管理服务 ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED返回错误代码。

如果指定了筛选器，则它必须是与资源架构相关的有效文档。 方言参数是可选的。 但是，如果筛选器字符串以 <开头，但不是 XML 片段，则要么包括 dialect 参数，要么在 flags 参数中设置 WSManFlagNonXmlText 标志。 有关详细信息，请参阅 枚举常量。

相应的 C++ 方法是 IWSManSession：：Enumerate。

示例

以下 VBScript 代码示例枚举由完全限定域名 (servername.domain.com) 指定的远程计算机上的Win32_LogicalDisk实例。 请注意，释放枚举对象会清除挂起的枚举请求。 DisplayOutput 子例程使用 Winrm 命令行工具 XML 转换文件 (WsmTxt.xsl) 以表格形式输出数据。

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

要求

要求 值
最低受支持的客户端
 Windows Vista
最低受支持的服务器
 Windows Server 2008
标头
WSManDisp.h
IDL
WSManDisp.idl
库
WSManDisp.tlb
DLL
WSMAuto.dll

另请参阅

会话

查询资源的特定实例

BatchItems

ResourceLocator