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 |
| 標頭 |
|
| Idl |
|
| 程式庫 |
|
| DLL |
|