ResourceLocator (objeto)

Artículo
06/13/2023

Objeto que proporciona la ruta de acceso a un recurso. Puede usar un objeto ResourceLocator en lugar de un URI de recurso en operaciones de objeto Session como Session.Get, Session.Put o Session.Enumerate.

Este objeto le permite:

Agregue uno o varios selectores que identifiquen una instancia determinada de un recurso. Esto es lo mismo que proporcionar un valor de clave en el URI del recurso para un recurso que usa claves. Para obtener más información, vea ResourceLocator.AddSelector. Puede realizar una operación similar mediante el parámetro filter en una llamada a Session.Enumerate.
Especifique una ruta de acceso de fragmento y un dialecto para obtener solo una propiedad de un recurso. También puede especificar uno o todos los elementos de una propiedad de matriz proporcionando el índice de matriz. Para obtener más información, consulte ResourceLocator.FragmentPath.
Agregue una o varias opciones que un origen de datos pueda requerir para procesar una solicitud. Para obtener más información, vea ResourceLocator.AddOption.

Para obtener más información, consulte Consulta de instancias específicas de un recurso.

Miembros

El objeto ResourceLocator tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

El objeto ResourceLocator tiene estos métodos.

Método	Descripción
AddOption	Agrega datos adicionales necesarios para procesar la solicitud.
AddSelector	Agrega un selector al objeto ResourceLocator .
ClearOptions	Quita las opciones del objeto ResourceLocator .
ClearSelectors	Quita todos los selectores de un objeto ResourceLocator .

Propiedades

El objeto ResourceLocator tiene estas propiedades.

Propiedad	Tipo de acceso	Descripción
FragmentDialect	Lectura/escritura	Obtiene o establece el dialecto de idioma de un fragmentode recursos.
FragmentPath	Lectura/escritura	Obtiene o establece la ruta de acceso de un fragmento o propiedad de recursos.
MustUnderstandOptions	Lectura/escritura	Obtiene o establece el valor MustUnderstandOptions del objeto ResourceLocator .
ResourceURI	Lectura/escritura	Obtiene o establece el URI del recurso en un objeto ResourceLocator .

Observaciones

El objeto ResourceLocator corresponde a la interfaz IWSManResourceLocator .

Ejemplos

En el siguiente ejemplo de código vbScript se obtienen las propiedades NumberOfLogicalProcessors y NumberOfCores de una instancia específica 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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	WSManDisp.h
IDL	WSManDisp.idl
Biblioteca	WSManDisp.tlb
Archivo DLL	WSMAuto.dll

Vea también

WinRM Scripting API