Objet ResourceLocator

Objet qui fournit le chemin d’accès à une ressource. Vous pouvez utiliser un objet ResourceLocator à la place d’un URI de ressource dans les opérations d’objet de session , telles que session. obtenir, session. putou session. Enumerate.

Cet objet vous permet d’effectuer les opérations suivantes :

  • Ajoutez un ou plusieurs sélecteurs identifiant une instance particulière d’une ressource. Cela revient à 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 Filter dans un appel à session. Enumerate.
  • Spécifiez un chemin d’accès de fragment et un dialecte pour obtenir une seule propriété d’une ressource. Vous pouvez également spécifier l’un ou l’ensemble des é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 interrogation d’instances spécifiques d’une ressource.

Membres

L’objet ResourceLocator possède les types de membres suivants :

Méthodes

L’objet ResourceLocator a ces méthodes.

Méthode Description
AddOption Ajoute les 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 a ces propriétés.

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

Remarques

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 du _ processeur Win32.

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
MIDL
WSManDisp. idl
Bibliothèque
WSManDisp. tlb
DLL
WSMAuto.dll

Voir aussi

API de script WinRM