Session. Enumerate, метод

Перечисляет таблицу, коллекцию данных или ресурс журнала. Чтобы создать запрос, включите параметр фильтра и параметр- диалект в перечисление. Для создания запросов также можно использовать объект ResourceLocator . Дополнительные сведения см. в разделе перечисление или составление списка всех экземпляров ресурса.

Синтаксис

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

Параметры

resourceUri [ окне]

Идентификатор извлекаемого ресурса.

Этот параметр может содержать одно из следующих:

Фильтр [ в необязательное]

Фильтр, который определяет, какие элементы в ресурсе возвращаются перечислением. При перечислении ресурса возвращаются только те элементы, которые соответствуют условиям фильтра. Включение параметра фильтра и параметра диалекта в перечисление преобразует перечисление в запрос. Пример см. в разделе запрос конкретных экземпляров ресурса.

Если у вас есть объект ResourceLocator для параметра resourceURI , этот параметр использовать не следует.

диалект [ в необязательное]

Язык, используемый фильтром. WQL— подмножество SQL, используемое WMI, является единственным поддерживаемым языком.

Если у вас есть объект ResourceLocator для параметра resourceURI , этот параметр использовать не следует.

Флаги [ в необязательное]

Параметр, который должен содержать флаг в перечислении _ _ всманенумфлагс . Дополнительные сведения см. в разделе константы перечисления.

Возвращаемое значение

Объект перечислителя , содержащий результаты перечисления.

Remarks

Дополнительные сведения об ограничении сетевых вызовов во время перечисления см. в описании свойства батчитемс .

имейте в виду, что если флаги содержат константы перечисления всманфлагхиерарчидипбасепропсонли или всманфлагхиерарчишаллов , то служба удаленного управления Windows служба возвращает код ошибки, _ _ _ _ не поддерживаемый режимом полиморфизма WSMAN.

Если задан фильтр, он должен быть допустимым документом в отношении схемы ресурса. Параметр диалекта является необязательным. Однако если строка фильтра начинается с <, но не является фрагментом XML, следует либо включить параметр диалекта , либо установить флаг всманфлагнонксмлтекст в параметре flags . Дополнительные сведения см. в разделе константы перечисления.

Соответствующий метод C++ — IWSManSession:: Enumerate.

Примеры

Следующий пример кода VBScript перечисляет экземпляры Win32 _ LogicalDisk на удаленном компьютере, указанном в полном доменном имени (servername.domain.com). Имейте в виду, что освобождение объектов перечисления, ожидающих запросов перечисления. Подпрограмма DisplayOutput использует XML-файл преобразования средства командной строки WinRM (Всмткст. 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

Requirements (Требования)

Требование Значение
Минимальная версия клиента
Windows Vista
Минимальная версия сервера
Windows Server 2008
Заголовок
Всмандисп. h
IDL
Всмандисп. idl
Библиотека
Всмандисп. tlb
DLL
WSMAuto.dll

См. также

Сеанс

Запрос конкретных экземпляров ресурса

батчитемс

ResourceLocator