共用方式為


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物件,則不應該使用此參數。

旗標 [in, 選擇性]

參數,必須包含 __WSManEnumFlags 列舉中的旗標。 如需詳細資訊,請參閱 列舉常數

傳回值

列舉值物件,其中包含列舉的結果。

備註

如需在列舉期間限制網路呼叫的詳細資訊,請參閱 BatchItems 屬性。

請注意,如果旗標包含 列舉常數WSManFlagHierarchyDeepBasePropsOnlyWSManFlagHierarchyShallow ,則 Windows 遠端系統管理服務會傳回錯誤碼 ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED

如果指定篩選準則,它必須是與資源架構相關的有效檔。 方言參數是選擇性的。 不過,如果篩選字串以 開頭 < ,但不是 XML 片段,則請在flags參數中包含方言參數或設定WSManFlagNonXmlText旗標。 如需詳細資訊,請參閱 列舉常數

對應的 C++ 方法是 IWSManSession::Enumerate

範例

下列 VBScript 程式碼範例會列舉完整功能變數名稱所指定遠端電腦上的 Win32_LogicalDisk 實例 (servername.domain.com) 。 請注意,釋放列舉物件會清除擱置的列舉要求。 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