Session. obten, méthode
Récupère la ressource spécifiée par l' URI et retourne une représentation XML de l’instance actuelle de la ressource.
Syntaxe
Session.Get( _
ByVal resourceUri, _
[ ByVal flags ] _
)
Paramètres
-
resourceuri [ dans]
-
Identificateur de la ressource à récupérer.
Ce paramètre peut contenir l’un des éléments suivants :
URI avec ou sans sélecteurs. Quand vous appelez la méthode obtenir avec un sélecteur pour obtenir une ressource WMI, utilisez la ou les propriétés de clé de l’objet. par exemple, dans l’exemple de code VBScript (Visual Basic scripting Edition) 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 fragmentsou des options.
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 pour protocole WS-Management, consultez la page index des spécifications de gestion.
-
indicateurs [ dans, facultatif]
-
Réservé. Doit avoir la valeur 0.
Valeur retournée
Représentation XML de la ressource.
Exemples
L’exemple de code VBScript suivant récupère la représentation XML de l’instance de _ service Win32 qui représente le service WinMgmt WMI 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 l’instance de service WinMgmt WMI à 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
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| MIDL |
|
| Bibliothèque |
|
| DLL |
|