Session.Get 메서드

  • 아티클

URI에 지정된 리소스를 검색하고 리소스의 현재 instance XML 표현을 반환합니다.

구문

Session.Get( _
  ByVal resourceUri, _
  [ ByVal flags ] _
)

매개 변수

resourceUri [in]

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

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

  • 선택기가 있거나 없는 URI입니다. 선택기를 사용하여 Get 메서드를 호출하여 WMI 리소스를 가져올 때는 개체의 키 속성 또는 속성을 사용합니다. 예를 들어 다음 VBScript(Visual Basic Scripting Edition) 코드 예제에서 키는 로 Win32_Service?Name=winmgmt지정됩니다. Win32_LocalTime 같은 싱글톤 클래스의 경우 선택기를 사용할 수 없습니다.

    strResourceUri = "http://schemas.microsoft.com/" _ 
    & "wbem/wsman/1/wmi/root/cimv2/Win32_Service?Name=winmgmt"

strResourceUri = "http://schemas.microsoft.com/" _ 
    & "wbem/wsman/1/wmi/root/cimv2/Win32_LocalTime"

  • 선택기, 조각 또는 옵션을 포함할 수 있는 ResourceLocator 개체입니다.

  • WS-Management 프로토콜 표준에 설명된 WS-Addressing 엔드포인트 참조입니다. WS-Management 프로토콜에 대한 공용 사양에 대한 자세한 내용은 관리 사양 인덱스 페이지를 참조하세요.

flags [in, optional]

예약되어 있습니다. 0으로 설정해야 합니다.

반환 값

리소스의 XML 표현입니다.

예제

다음 VBScript 코드 예제에서는 로컬 컴퓨터에서 WMI Winmgmt 서비스를 나타내는 Win32_Service instance XML 표현을 검색합니다.


'Create a WSMan object.
Set objWsman = CreateObject( "WSMAN.Automation" )
If objWsman is Nothing Then
    WScript.Echo "Failed to create WSMAN Automation object"
    WScript.Quit
End If 

'Create a Session object.
Set objSession = objWsman.CreateSession
If objSession is Nothing Then
    WScript.Echo "Failed to create WSMAN Session object"
    WScript.Quit
End If 


strResourceUri = "http://schemas.microsoft.com/" _ 
    & "wbem/wsman/1/wmi/root/cimv2/Win32_Service?Name=winmgmt"

On Error Resume Next
xmlResource = objSession.Get( strResourceUri )
WScript.Echo "Response message: " & Chr(10) & xmlResource
If Err.Number <> 0 Then
    DisplayErrorInfo
End If
On Error Goto 0

Sub DisplayErrorInfo()
    WScript.Echo "An error has occurred."     
    WScript.Echo
    WScript.Echo "Error Info"
    WScript.Echo "-----------"
    WScript.Echo "Number      : 0x" & hex(Err.number)
    WScript.Echo "Description : " & Err.Description
    WScript.Echo "Source      : " & Err.Source
    WScript.Echo "HelpFile    : " & Err.helpfile
    WScript.Echo "HelpContext : " & Err.HelpContext    
    WScript.Echo Err.Clear    
End Sub

다음 VBScript 코드 예제에서는 원격 컴퓨터에서 WMI Winmgmt 서비스 instance 검색합니다. 원격 컴퓨터는 정규화된 도메인 이름(servername.domain.com)으로 식별됩니다. 로컬 버전과 원격 버전 간의 유일한 차이점은 WSMan.CreateSession 호출에서 원격 컴퓨터의 사양입니다.

Const RemoteComputer = "servername.domain.com"

'Create a WSMan object.
Set objWsman = CreateObject( "WSMAN.Automation" )
If objWsman is Nothing Then
    WScript.Echo "Failed to create WSMAN Automation object"
    WScript.Quit
End If 

'Create a Session object.
Dim objSession
Set objSession = objWsman.CreateSession( "https://" & RemoteComputer )
If objSession is Nothing Then
    WScript.Echo "Failed to create WSMAN Session object"
    WScript.Quit
End If 


strResourceUri = "http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/" _ 
    & "Win32_Service?Name=winmgmt"


On Error Resume Next
xmlResource = objSession.Get( strResourceUri )
WScript.Echo "Response message: " & Chr(10) & xmlResource
If Err.Number <> 0 Then
    DisplayErrorInfo
End If
On Error Goto 0

Sub DisplayErrorInfo()
    WScript.Echo "An error has occurred."     
    WScript.Echo
    WScript.Echo "Error Info"
    WScript.Echo "-----------"
    WScript.Echo "Number      : 0x" & hex(Err.number)
    WScript.Echo "Description : " & Err.Description
    WScript.Echo "Source      : " & Err.Source
    WScript.Echo "HelpFile    : " & Err.helpfile
    WScript.Echo "HelpContext : " & Err.HelpContext    
    WScript.Echo Err.Clear    
End Sub

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista
지원되는 최소 서버
 Windows Server 2008
헤더
WSManDisp.h
IDL
WSManDisp.idl
라이브러리
WSManDisp.tlb
DLL
WSMAuto.dll

추가 정보

세션