Session.Get, méthode
Récupère la ressource spécifiée par l’URI et retourne une représentation XML de la instance actuelle de la ressource.
Session.Get( _
ByVal resourceUri, _
[ ByVal flags ] _
)
-
resourceUri [in]
-
Identificateur de la ressource à récupérer.
Ce paramètre peut contenir l’un des éléments suivants :
URI avec ou sans sélecteurs. Lorsque vous appelez la méthode Get avec un sélecteur pour obtenir une ressource WMI, utilisez la ou les propriétés de la clé de l’objet . Par exemple, dans l’exemple de code Visual Basic Scripting Edition (VBScript) suivant, la clé est spécifiée par
Win32_Service?Name=winmgmt
. Pour les classes singleton, telles que Win32_LocalTime, vous ne pouvez pas utiliser de sélecteur.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"
Objet ResourceLocator qui peut contenir des sélecteurs, des fragments ou desoptions.
Une référence de point de terminaison WS-Addressing , comme décrit dans la norme de protocole WS-Management. Pour plus d’informations sur la spécification publique du protocole WS-Management, consultez Page d’index des spécifications de gestion.
-
indicateurs [in, facultatif]
-
Réservé. Doit avoir la valeur 0.
Représentation XML de la ressource.
L’exemple de code VBScript suivant récupère la représentation XML du Win32_Service instance qui représente le service WMI Winmgmt sur l’ordinateur local.
'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
L’exemple de code VBScript suivant récupère le service WMI Winmgmt instance à partir d’un ordinateur distant. L’ordinateur distant est identifié par le nom de domaine complet (servername.domain.com). La seule différence entre la version locale et la version distante est la spécification de l’ordinateur distant dans l’appel à 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
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows Vista |
Serveur minimal pris en charge |
Windows Server 2008 |
En-tête |
|
IDL |
|
Bibliothèque |
|
DLL |
|