Oggetto ResourceLocator

Articolo
06/13/2023

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
Proprietà

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

Share via