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 |
|
| MIDL |
|
| Bibliothèque |
|
| DLL |
|