Freigeben über


ResourceLocator-Objekt

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

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