Objet ResourceLocator

Objet qui fournit le chemin d’accès à une ressource. Vous pouvez utiliser un objet ResourceLocator au lieu d’un URI de ressource dans les opérations d’objet session telles que Session.Get, Session.Put ou Session.Énumération.

Cet objet vous permet de :

  • Ajoutez un ou plusieurs sélecteurs qui identifient une instance particulière d’une ressource. Il s’agit de la même valeur que de fournir une valeur de clé dans l’URI de ressource pour une ressource qui utilise des clés. Pour plus d’informations, consultez ResourceLocator.AddSelector. Vous pouvez effectuer une opération similaire à l’aide du paramètre de filtre dans un appel à Session.Énumération.
  • Spécifiez un chemin d’accès et un dialecte fragment pour obtenir une seule propriété d’une ressource. Vous pouvez également spécifier un ou tous les éléments d’une propriété de tableau en fournissant l’index de tableau. Pour plus d’informations, consultez ResourceLocator.FragmentPath.
  • Ajoutez une ou plusieurs options qu’une source de données peut nécessiter pour traiter une demande. Pour plus d’informations, consultez ResourceLocator.AddOption.

Pour plus d’informations, consultez Interroger des instances spécifiques d’une ressource.

Membres

L’objet ResourceLocator a ces types de membres :

Méthodes

L’objet ResourceLocator a ces méthodes.

Méthode Description
AddOption Ajoute des données supplémentaires requises pour traiter la demande.
AddSelector Ajoute un sélecteur à l’objet ResourceLocator .
ClearOptions Supprime toutes les options de l’objet ResourceLocator .
ClearSelectors Supprime tous les sélecteurs d’un objet ResourceLocator .

Propriétés

L’objet ResourceLocator possède ces propriétés.

Propriété Type d’accès Description
FragmentDialect
Lecture/écriture
Obtient ou définit le dialecte de langue pour un resourcefragment.
FragmentPath
Lecture/écriture
Obtient ou définit le chemin d’accès d’une ressourceou d’une propriété.
MustUnderstandOptions
Lecture/écriture
Obtient ou définit la valeur MustUnderstandOptions pour l’objet ResourceLocator .
ResourceURI
Lecture/écriture
Obtient ou définit l’URI de ressource dans un objet ResourceLocator .

Notes

L’objet ResourceLocator correspond à l’interface IWSManResourceLocator .

Exemples

L’exemple de code VBScript suivant obtient les propriétés NumberOfLogicalProcessors et NumberOfCores à partir d’une instance spécifique de Win32_Processor.

Option Explicit
Dim strUri
strUri = "http://schemas.microsoft.com/wbem/wsman/1/" _
    & "wmi/root/cimv2/Win32_Processor"
Const FragmentDialect = _
    "https://www.w3.org/TR/1999/REC-xpath-19991116"

Dim WSMan
Set WSMan = CreateObject("WSMan.Automation")

Dim Session
Set Session = WSMan.CreateSession

Dim Locator
Set Locator = WSMan.CreateResourceLocator(strUri)

Locator.AddSelector "DeviceID", "CPU0"

Dim NumberOfCores_XML
Locator.FragmentPath = "NumberOfCores"
Locator.FragmentDialect = FragmentDialect
NumberOfCores_XML = Session.Get(Locator)
DisplayOutput NumberOfCores_XML

Dim NumberOfLogicalProcessors_XML
Locator.FragmentPath = "NumberOfLogicalProcessors"
Locator.FragmentDialect = FragmentDialect
NumberOfLogicalProcessors_XML = Session.Get(Locator)

DisplayOutput NumberOfLogicalProcessors_XML

'****************************************************
' Displays WinRM XML message using built-in XSL
'****************************************************

Sub DisplayOutput( strWinRMXml )
    Dim xmlFile, xslFile
    Set xmlFile = CreateObject( "MSXml2.DOMDocument.3.0" )    
    Set xslFile = CreateObject( "MSXml2.DOMDocument.3.0" )
    xmlFile.LoadXml( strWinRMXml )
    xslFile.Load( "WsmTxt.xsl" )
    Wscript.Echo xmlFile.TransformNode( xslFile )           
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
WSManDisp.h
IDL
WSManDisp.idl
Bibliothèque
WSManDisp.tlb
DLL
WSMAuto.dll

Voir aussi

WinRM Scripting API