Compartir a través de


ResourceLocator (objeto)

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

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