ResourceLocator-Objekt

Artikel
06/13/2023

Ein -Objekt, das den Pfad zu einer Ressource bereitstellt. Sie können ein ResourceLocator-Objekt anstelle eines Ressourcen-URI in Session-Objektvorgängen wie Session.Get, Session.Put oder Session.Enumerate verwenden.

Mit diesem Objekt können Sie Folgendes ausführen:

Fügen Sie einen oder mehrere Selektoren hinzu, die einen bestimmten instance einer Ressource identifizieren. Dies ist identisch mit der Angabe eines Schlüsselwerts im Ressourcen-URI für eine Ressource, die Schlüssel verwendet. Weitere Informationen finden Sie unter ResourceLocator.AddSelector. Sie können einen ähnlichen Vorgang mithilfe des Filterparameters in einem Aufruf von Session.Enumerate ausführen.
Geben Sie einen Fragmentpfad und einen Dialekt an, um nur eine Eigenschaft einer Ressource abzurufen. Sie können auch ein oder alle Elemente einer Arrayeigenschaft angeben, indem Sie den Arrayindex angeben. Weitere Informationen finden Sie unter ResourceLocator.FragmentPath.
Fügen Sie eine oder mehrere Optionen hinzu, die für eine Datenquelle möglicherweise erforderlich sind, um eine Anforderung zu verarbeiten. Weitere Informationen finden Sie unter ResourceLocator.AddOption.

Weitere Informationen finden Sie unter Abfragen nach bestimmten Instanzen einer Ressource.

Member

Das ResourceLocator-Objekt verfügt über die folgenden Membertypen:

Methoden
Eigenschaften

Methoden

Das ResourceLocator-Objekt verfügt über diese Methoden.

Methode	BESCHREIBUNG
AddOption	Fügt zusätzliche Daten hinzu, die für die Verarbeitung der Anforderung erforderlich sind.
AddSelector	Fügt dem ResourceLocator-Objekt einen Selektor hinzu.
ClearOptions	Entfernt alle Optionen aus dem ResourceLocator-Objekt .
ClearSelectors	Entfernt alle Selektoren aus einem ResourceLocator-Objekt .

Eigenschaften

Das ResourceLocator-Objekt verfügt über diese Eigenschaften.

Eigenschaft	Zugriffstyp	BESCHREIBUNG
FragmentDialect	Lesen/Schreiben	Ruft den Sprachdialekt für ein Ressourcenfragment ab oder legt diese fest.
FragmentPath	Lesen/Schreiben	Ruft den Pfad für ein Ressourcenfragment oder eine Eigenschaft ab oder legt den Pfad fest.
MustUnderstandOptions	Lesen/Schreiben	Ruft den MustUnderstandOptions-Wert für das ResourceLocator-Objekt ab oder legt diese fest.
ResourceURI	Lesen/Schreiben	Ruft den Ressourcen-URI in einem ResourceLocator-Objekt ab oder legt diese fest.

Bemerkungen

Das ResourceLocator-Objekt entspricht der IWSManResourceLocator-Schnittstelle .

Beispiele

Im folgenden VBScript-Codebeispiel werden die Eigenschaften NumberOfLogicalProcessors und NumberOfCores von einer bestimmten instance von Win32_Processor abgerufen.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Header	WSManDisp.h
IDL	WSManDisp.idl
Bibliothek	WSManDisp.tlb
DLL	WSMAuto.dll

Siehe auch

WinRM-Skript-API