Session.Enumerate 메서드

  • 아티클

테이블, 데이터 수집 또는 로그 리소스를 열거합니다. 쿼리를 만들려면 필터 매개 변수와 언어 매개 변수를 열거형에 포함합니다. ResourceLocator 개체를 사용하여 쿼리를 만들 수도 있습니다. 자세한 내용은 리소스 인스턴스 모두 열거 또는 나열을 참조하세요.

구문

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

매개 변수

resourceUri [in]

검색할 리소스의 식별자입니다.

이 매개 변수는 다음 중 하나를 포함할 수 있습니다.

필터 [in, optional]

열거형에서 반환되는 리소스의 항목을 정의하는 필터입니다. 리소스가 열거되면 필터 조건과 일치하는 항목만 반환됩니다. 열거형에 필터 매개 변수와 언어 매개 변수를 포함하면 열거형이 쿼리로 변환됩니다. 예제는 리소스의 특정 인스턴스 쿼리를 참조하세요.

resourceURI 매개 변수에 대한 ResourceLocator 개체 가 있는 경우 이 매개 변수를 사용하면 안 됩니다.

언어 [in, optional]

필터에서 사용하는 언어입니다. WMI에서 사용하는 SQL의 하위 집합인 WQL은 지원되는 유일한 언어입니다.

resourceURI 매개 변수에 대한 ResourceLocator 개체 가 있는 경우 이 매개 변수를 사용하면 안 됩니다.

flags [in, optional]

__WSManEnumFlags 열거형에 플래그를 포함해야 하는 매개 변수입니다. 자세한 내용은 열거형 상수를 참조하세요.

반환 값

열 거 형의 결과를 포함하는 열거자 개체입니다.

설명

열거 중에 네트워크 호출을 제한하는 방법에 대한 자세한 내용은 BatchItems 속성을 참조하세요.

플래그에 열거형 상수WSManFlagHierarchyDeepBasePropsOnly 또는 WSManFlagHierarchyShallow 가 포함된 경우 Windows 원격 관리 서비스는 ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED 오류 코드를 반환합니다.

필터를 지정하는 경우 리소스의 스키마와 관련하여 유효한 문서여야 합니다. 언어 매개 변수는 선택 사항입니다. 그러나 필터 문자열이 로 <시작하지만 XML 조각이 아닌 경우 언어 매개 변수를 포함하거나 플래그 매개 변수에 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