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
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 |
|
| IDL |
|
| Biblioteca |
|
| DLL |
|