Partager via


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.Enumerate.

Cet objet vous permet de :

  • Ajoutez un ou plusieurs sélecteurs qui identifient un instance particulier 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 de filtre dans un appel à Session.Enumerate.
  • Spécifiez un chemin d’accès fragment et un dialecte 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 du tableau. Pour plus d’informations, consultez ResourceLocator.FragmentPath.
  • Ajoutez une ou plusieurs options dont une source de données peut avoir besoin 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 a les types de membres suivants :

Méthodes

L’objet ResourceLocator possède 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 a ces propriétés.

Propriété Type d’accès Description
FragmentDialect
Lecture/écriture
Obtient ou définit le dialecte de langue d’un fragmentde ressource.
FragmentPath
Lecture/écriture
Obtient ou définit le chemin d’accès d’une propriété ou d’un fragmentde ressource.
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 d’un 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

Spécifications

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