Session.Create 메서드

리소스의 새 instance 만들고 새 개체의 EPR(엔드포인트 참조)을 반환합니다.

구문

Session.Create( _
  ByVal resourceUri, _
  ByVal resource, _
  [ ByVal flags ] _
)

매개 변수

resourceUri [in]

만들 리소스의 식별자입니다.

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

• 하나 이상의 선택기가 있는 URI입니다. WMI 플러그 인은 WS관리 프로토콜 수신기 이외의 리소스 만들기를 지원하지 않습니다.
• 선택기, 조각 또는 옵션을 포함할 수 있는 ResourceLocator 개체입니다.
• WS-Management 프로토콜 표준에 설명된 WS-Addressing 엔드포인트 참조입니다. WS-Management 프로토콜에 대한 공용 사양에 대한 자세한 내용은 관리 사양 인덱스 페이지를 참조하세요.

resource

리소스 콘텐츠가 포함된 XML입니다.

flags [in, optional]

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

반환 값

새 리소스의 EPR입니다.

설명

Session.Create 는 리소스의 새 인스턴스를 만드는 데만 사용됩니다. Session.Put 메서드를 사용하여 리소스의 기존 인스턴스를 업데이트합니다. 새 리소스 URI를 가져온 후 Session.Get 을 호출하여 새 개체를 검색할 수 있습니다. 새 개체에는 새 개체를 만들 때 리소스 공급자가 할당하는 모든 속성이 포함됩니다. 예를 들어 새 WS-Management 프로토콜 수신기 를 만들고 Session.Get을 사용하여 수신기 개체를 검색하는 경우 Port, Enabled 및 ListeningOn 속성도 가져옵니다.

WMI 플러그 인은 WS-Management 프로토콜 수신기 이외의 리소스 만들기를 지원하지 않습니다.

다음 구문은 이 메서드를 호출하는 데 사용됩니다.

uri = session.Create("<resourceUri>", "<resource>")

예제

다음 VBScript 코드 예제에서는 Session.Create 를 호출하여 로컬 컴퓨터에 수신기를 만듭니다.

'Create a WSMan object
Set oWsman = CreateObject( "WSMAN.Automation" )

'Create a Session object
Set oSession = oWsman.CreateSession

'Define resourceUri and inputXml 
resourceUri = "http://schemas.microsoft.com/wbem/wsman/1/"_
    & "config/Listener?Address=*+Transport=HTTP"

inputXml = _
    "<cfg:Listener xmlns:cfg=""https://schemas.dmtf.org/wbem/wsman/1/"_
    & "config/Listener.xsd"">" _
    & "<cfg:Hostname>" & GetFQDNName() & "</cfg:Hostname>" _            
    & "</cfg:Listener>"

'Perform the create operation.
response = oSession.Create( resourceUri, inputXml )
WScript.Echo "Response message: " & Chr(10) & response

Function GetFQDNName()
    Dim oShell, userDNSDomain, localComputerName
    Set oShell = CreateObject("WScript.Shell")
    userDNSDomain = oShell.ExpandEnvironmentStrings("%USERDNSDOMAIN%")

    localComputerName = _
        oShell.ExpandEnvironmentStrings("%ComputerName%")
    If userDNSDomain = "%USERDNSDOMAIN%" Then
        GetFQDNName= localComputerName
    Else
        GetFQDNName= localComputerName & "." & userDNSDomain
    End If
End Function

요구 사항

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

추가 정보

세션

WS-Management 프로토콜