Session.Get メソッド

URI で指定されたリソースを取得し、リソースの現在のインスタンスの XML 表現を返します。

構文

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

パラメーター

resourceUri [in]

取得するリソースの識別子。

このパラメーターには、次のいずれかを含めることができます。

• セレクターの有無に関係なく URI。 セレクターで Get メソッドを呼び出して WMI リソースを取得する場合は、オブジェクトのキー プロパティまたはプロパティを使用します。 たとえば、次の Visual Basic Scripting Edition (VBScript) コード例では、 で 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 インスタンスの 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 サービス インスタンスを取得します。 リモート コンピューターは、完全修飾ドメイン名 (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

こちらもご覧ください

Session