Session.Identify method

The Session.Identify method queries a remote computer to determine if it supports the WS-Management protocol. For more information, see Detecting Whether a Remote Computer Supports WS-Management Protocol.

Syntax


Session.Identify( _
  [ ByVal flags ] _
)

Parameters

flags [in, optional]

To send the request in authenticated mode use authentication constant from the WSManSessionFlags enumeration. To send in unauthenticated mode, use WSManFlagUseNoAuthentication. For more information, see Authentication Constants.

Return value

An XML string that specifies the WS-Management protocol version, the operating system vendor and, if the request was sent authenticated, the operating system version.

Remarks

Session.Identify is based on the WS-Management Protocol operation defined as wsmanIdentity. This is specified in the SOAP packet as follows:


xmlns:wsmid="http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity"

Examples

The following VBScript example sends an unauthenticated Identify request to the remote computer named Remote in the same domain.


set WSMan = CreateObject("Wsman.Automation")
set Session = WSMan.CreateSession("Remote", _
  WSMan.SessionFlagUseNoAuthentication)
WScript.Echo Session.Identify

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

WSManDisp.h

IDL

WSManDisp.idl

Library

WSManDisp.tlb

DLL

WSMAuto.dll

See also

Session
IWSManSession::Identify
WS-Management Protocol

 

 

Show: