ResourceLocator 개체

리소스의 경로를 제공하는 개체입니다. Session.Get, Session.Put 또는 Session.Enumerate와 같은 Session 개체 작업에서 리소스 URI 대신 ResourceLocator 개체를 사용할 수 있습니다.

이 개체를 사용하면 다음을 수행할 수 있습니다.

• 리소스의 특정 instance 식별하는 하나 이상의 선택기를 추가합니다. 이는 키를 사용하는 리소스에 대해 리소스 URI에 키 값을 제공하는 것과 같습니다. 자세한 내용은 ResourceLocator.AddSelector를 참조하세요. Session.Enumerate 호출에서 필터 매개 변수를 사용하여 유사한 작업을 수행할 수 있습니다.
• 조각 경로 및 방언을 지정하여 리소스의 속성을 하나만 가져옵니다. 배열 인덱스 제공을 통해 배열 속성의 요소 중 하나 또는 전부를 지정할 수도 있습니다. 자세한 내용은 ResourceLocator.FragmentPath를 참조하세요.
• 데이터 원본이 요청을 처리하는 데 필요할 수 있는 하나 이상의 옵션을 추가합니다. 자세한 내용은 ResourceLocator.AddOption을 참조하세요.

자세한 내용은 리소스의 특정 인스턴스 쿼리를 참조하세요.

멤버

ResourceLocator 개체에는 다음과 같은 유형의 멤버가 있습니다.

• 메서드
• 속성

메서드

ResourceLocator 개체에는 이러한 메서드가 있습니다.

메서드	Description
AddOption	요청을 처리하는 데 필요한 추가 데이터를 추가합니다.
AddSelector	ResourceLocator 개체에 선택기를 추가합니다.
ClearOptions	ResourceLocator 개체에서 옵션을 제거합니다.
ClearSelectors	ResourceLocator 개체에서 모든 선택기를 제거합니다.

속성

ResourceLocator 개체에는 이러한 속성이 있습니다.

속성	액세스 유형	설명
FragmentDialect	읽기/쓰기	리소스조각에 대한 언어 언어를 가져오거나 설정합니다.
FragmentPath	읽기/쓰기	리소스조각 또는 속성의 경로를 가져오거나 설정합니다.
MustUnderstandOptions	읽기/쓰기	ResourceLocator 개체에 대한 MustUnderstandOptions 값을 가져오거나 설정합니다.
ResourceURI	읽기/쓰기	ResourceLocator 개체의 리소스 URI를 가져오거나 설정합니다.

설명

ResourceLocator 개체는 IWSManResourceLocator 인터페이스에 해당합니다.

예제

다음 VBScript 코드 예제에서는 특정 instance Win32_ProcessorNumberOfLogicalProcessors 및 NumberOfCores 속성을 가져옵니다.

Option Explicit
Dim strUri
strUri = "http://schemas.microsoft.com/wbem/wsman/1/" _
    & "wmi/root/cimv2/Win32_Processor"
Const FragmentDialect = _
    "https://www.w3.org/TR/1999/REC-xpath-19991116"

Dim WSMan
Set WSMan = CreateObject("WSMan.Automation")

Dim Session
Set Session = WSMan.CreateSession

Dim Locator
Set Locator = WSMan.CreateResourceLocator(strUri)

Locator.AddSelector "DeviceID", "CPU0"

Dim NumberOfCores_XML
Locator.FragmentPath = "NumberOfCores"
Locator.FragmentDialect = FragmentDialect
NumberOfCores_XML = Session.Get(Locator)
DisplayOutput NumberOfCores_XML

Dim NumberOfLogicalProcessors_XML
Locator.FragmentPath = "NumberOfLogicalProcessors"
Locator.FragmentDialect = FragmentDialect
NumberOfLogicalProcessors_XML = Session.Get(Locator)

DisplayOutput NumberOfLogicalProcessors_XML

'****************************************************
' 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

추가 정보

WinRM 스크립팅 API