Freigeben über

Ressourcen-URIs

  • Artikel

Ein Ressourcen-URI ist ein Bezeichner für einen eindeutigen Verwaltungsvorgang oder Wert, der von Verwaltungsdiensten verwendet wird, die das WS-Management-Protokoll implementieren. Ein Verwaltungswert könnte die Temperatur innerhalb eines Computers sein. Ein Beispiel für einen Verwaltungsvorgang ist das Starten eines angehaltenen Diensts oder das Festlegen eines Datenträgervolumes-Benutzerkontingents.

Ressourcen-URI-Format

Ein URI besteht aus einem Präfix und einem Pfad zu einer Ressource, wie im folgenden Beispiel gezeigt:

"http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk"

Diese Schemaspezifikation gibt an, dass der URI auf Version 1 des offiziellen WS-Management Protokolls basiert und dass die Ressource ein Win32_LogicalDisk im Namespace "root\cimv2" des WMI-Repositorys ist. URI-Präfixe enthalten eine Schemaspezifikation, z. B. "schemas.microsoft.com/wbem/wsman/1/wmi" und einen bestimmten Ressourcentyp, z. B. Win32_LogicalDisk. Weitere Informationen zum Identifizieren einer bestimmten Instanz einer WMI-Klasse finden Sie unter Windows-Remoteverwaltung und WMI-.

Weitere Informationen finden Sie unter URI-Präfixe.

Typen von Ressourcen-URIs

Während Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) die primäre Quelle von Verwaltungsdaten für Windows-basierte Betriebssysteme ist, sind auch andere Verwaltungsschemaquellen vorhanden.

In der folgenden Liste werden verschiedene Arten von Ressourcen-URIs beschrieben, die von der Windows-Remoteverwaltung verwendet werden:

Groß-/Kleinschreibung

Das WMI-Plug-Ins behält den Fall des in einer Anforderung empfangenen Ressourcen-URI bei. Um jedoch die Interoperabilität mit anderen Implementierungen des WS-Management Protokolls sicherzustellen, verwenden Sie den richtigen Fall für die angeforderte Ressource im Ressourcen-URI. Der richtige Fall ist die vom Ressourcenanbieter definierte Schreibweise.

Ressourcen-URIs erfordern zwar keine Groß-/Kleinschreibung, Fragment XML jedoch. Ein Fragment gibt nur eine Eigenschaft und nicht den gesamten Satz von Eigenschaften für eine Ressource an. Bei WMI-Ressourcen ruft die Fragmentsyntax eine Eigenschaft aus einer Ressourceninstanz ab. Zum Beispiel erfordert das Abrufen der Version-Eigenschaft aus Win32_OperatingSystem die Verwendung eines Fragments. Weitere Informationen zu Fragmenten finden Sie unter "Hinzufügen einer Auswahl zu einem ResourceLocator- oder IWSManResourceLocator-Objekt" in Windows-Remoteverwaltung und WMI-.

Nach xml- und XPath- Standards erzwingt das WMI-Plug-In die Groß-/Kleinschreibung für Fragmente und XML, die die Eingabeparameter für eine Methode definiert. Die Groß-/Kleinschreibung ist erforderlich, um den XPath 1.0/Level 1-Standard zu unterstützen. Um WMI-Daten über WinRM abzurufen, bedeutet die Groß-/Kleinschreibung, dass die Namen von WMI-Klassen, -Eigenschaften und -Methoden mit dem Fall des Namens übereinstimmen müssen, der im WMI-Repository gefunden wurde.

Weitere Informationen finden Sie unter XPath-Syntax.

Beispiele für Groß-/Kleinschreibung

Beispielsweise kann ein Skript, das die SECURITY_DESCRIPTOR-Eigenschaft aus einer Instanz der WMI-Win32_Service Klasse abruft, für die Namen im Fragmentpfad nur den URI in Groß-/Kleinschreibung verwenden. Das WinRM-WMI-Plug-In gibt einen Fehler für das folgende VBScript-Beispiel zurück, da der für die FragmentPath- bereitgestellte XPath-XML-Code nicht den richtigen Fall verwendet. Im WMI-Repository wird die Klasse "Win32_Service" geschrieben.

RResourceUri = "http://schemas.microsoft.com/wbem/wsman/1/"_& "wmi/root/cimv2/Win32_Service?Name=winrm"
Set WSMan = CreateObject("WSMan.Automation")
Set Locator = WSMan.CreateResourceLocator(Resourceuri)
Locator.FragmentPath = "/Win32_SERVICE/Name"
Set Session = WSMan.Createsession
xml = Session.Get(Locator)
WScript.Echo xml

Die folgende Version desselben Beispiels zeigt die richtige Verwendung der Groß-/Kleinschreibung für die Win32_Service-Klasse und SECURITY_DESCRIPTOR-Eigenschaft.

ResourceUri = "http://schemas.microsoft.com/wbem/wsman/1/"_
    & "wmi/root/cimv2/Win32_Service?Name=winrm"
Set WSMan = CreateObject("WSMan.Automation")
Set Locator = WSMan.CreateResourceLocator(Resourceuri)
Locator.FragmentPath = "/Win32_Service/Name"
Set Session = WSMan.Createsession
xml = Session.Get(Locator)
WScript.Echo xml

Informationen zur Windows-Remoteverwaltung

Remotehardwareverwaltung

ResourceLocator-