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="https://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

Requirement Value
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