Objet ResourceLocator

Article
06/13/2023

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
Propriétés

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

Partager via