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 屬性。

請注意，如果旗標包含 列舉常數WSManFlagHierarchyDeepBasePropsOnly 或 WSManFlagHierarchyShallow ，則 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