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 |
ヘッダー |
|
IDL |
|
ライブラリ |
|
[DLL] |
|