Oggetto ResourceLocator

Oggetto che fornisce il percorso di una risorsa. È possibile utilizzare un oggetto ResourceLocator anziché un URI di risorsa nelle operazioni dell'oggetto Session, ad esempio Session.Get, Session.Put o Session.Enumerate.

Questo oggetto consente di:

  • Aggiungere uno o più selettori che identificano una particolare istanza di una risorsa. Ciò equivale a fornire un valore di chiave nell'URI della risorsa per una risorsa che usa chiavi. Per altre informazioni, vedere ResourceLocator.AddSelector. È possibile eseguire un'operazione simile usando il parametro di filtro in una chiamata a Session.Enumerate.
  • Specificare un percorso di frammento e un dialetto per ottenere una sola proprietà di una risorsa. È anche possibile specificare uno o tutti gli elementi di una proprietà di matrice specificando l'indice della matrice. Per altre informazioni, vedere ResourceLocator.FragmentPath.
  • Aggiungere una o più opzioni che un'origine dati può richiedere per elaborare una richiesta. Per altre informazioni, vedere ResourceLocator.AddOption.

Per altre informazioni, vedere Esecuzione di query per istanze specifiche di una risorsa.

Membri

L'oggetto ResourceLocator ha questi tipi di membri:

Metodi

L'oggetto ResourceLocator dispone di questi metodi.

Metodo Descrizione
AddOption Aggiunge dati aggiuntivi necessari per elaborare la richiesta.
AddSelector Aggiunge un selettore all'oggetto ResourceLocator .
ClearOptions Rimuove tutte le opzioni dall'oggetto ResourceLocator .
ClearSelectors Rimuove tutti i selettori da un oggetto ResourceLocator .

Proprietà

L'oggetto ResourceLocator ha queste proprietà.

Proprietà Tipo di accesso Descrizione
FragmentDialect
Lettura/Scrittura
Ottiene o imposta il dialetto linguistico per un frammentodi risorsa.
FragmentPath
Lettura/Scrittura
Ottiene o imposta il percorso di un frammento di risorsa o di una proprietà.
MustUnderstandOptions
Lettura/Scrittura
Ottiene o imposta il valore MustUnderstandOptions per l'oggetto ResourceLocator .
ResourceURI
Lettura/Scrittura
Ottiene o imposta l'URI della risorsa in un oggetto ResourceLocator .

Commenti

L'oggetto ResourceLocator corrisponde all'interfaccia IWSManResourceLocator .

Esempio

Nell'esempio di codice VBScript seguente vengono ottenute le proprietà NumberOfLogicalProcessors e NumberOfCores da un'istanza specifica di 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

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista
Server minimo supportato
Windows Server 2008
Intestazione
WSManDisp.h
IDL
WSManDisp.idl
Libreria
WSManDisp.tlb
DLL
WSMAuto.dll

Vedi anche

WinRM Scripting API