Objeto ResourceLocator

Um objeto que fornece o caminho para um recurso. Você pode usar um objeto ResourceLocator em vez de um URI de recurso em operações de objeto de sessão , como Session.Get, Session.Put ou Session.Enumerate.

Esse objeto permite que você:

• Adicione um ou mais seletores que identifiquem uma instância específica de um recurso. Isso é o mesmo que fornecer um valor de chave no URI do recurso para um recurso que usa chaves. Para obter mais informações, consulte ResourceLocator.AddSelector. Você pode fazer uma operação semelhante usando o parâmetro filter em uma chamada para Session.Enumerate.
• Especifique um caminho de fragmento e um dialeto para obter apenas uma propriedade de um recurso. Você também pode especificar um ou todos os elementos de uma propriedade de matriz fornecendo o índice da matriz. Para obter mais informações, consulte ResourceLocator.FragmentPath.
• Adicione uma ou mais opções que uma fonte de dados pode exigir para processar uma solicitação. Para obter mais informações, consulte ResourceLocator.AddOption.

Para obter mais informações, consulte Consultando instâncias específicas de um recurso.

Membros

O objeto ResourceLocator tem estes tipos de membros:

• Métodos
• Propriedades

Métodos

O objeto ResourceLocator tem esses métodos.

Método	Descrição
AddOption	Adiciona dados adicionais necessários para processar a solicitação.
AddSelector	Adiciona um seletor ao objeto ResourceLocator .
ClearOptions	Remove todas as opções do objeto ResourceLocator .
ClearSelectors	Remove todos os seletores de um objeto ResourceLocator .

Propriedades

O objeto ResourceLocator tem essas propriedades.

Propriedade	Tipo de acesso	Descrição
FragmentDialect	Leitura/gravação	Obtém ou define o dialeto do idioma para um fragmentode recurso.
FragmentPath	Leitura/gravação	Obtém ou define o caminho para um fragmento ou propriedade de recurso.
MustUnderstandOptions	Leitura/gravação	Obtém ou define o valor MustUnderstandOptions para o objeto ResourceLocator .
Resourceuri	Leitura/gravação	Obtém ou define o URI do recurso em um objeto ResourceLocator .

Comentários

O objeto ResourceLocator corresponde à interface IWSManResourceLocator .

Exemplos

O exemplo de código VBScript a seguir obtém as propriedades NumberOfLogicalProcessors e NumberOfCores de uma instância específica do 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	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	WSManDisp.h
IDL	WSManDisp.idl
Biblioteca	WSManDisp.tlb
DLL	WSMAuto.dll

Confira também

API de script do WinRM