Ressourcen-URIs

  • Artikel

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

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 eine 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 instance einer WMI-Klasse finden Sie unter Windows-Remoteverwaltung und WMI.

Weitere Informationen finden Sie unter URI-Präfixe.

Typen von Ressourcen-URIs

Während die Windows-Verwaltungsinstrumentation (WMI) die primäre Quelle für Verwaltungsdaten für Windows-basierte Betriebssysteme ist, gibt es auch andere Quellen für das Verwaltungsschema.

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

Groß- und Kleinschreibung

Das WMI-Plug-In behält die Groß-/Kleinschreibung des Ressourcen-URI bei, der in einer Anforderung empfangen wurde. Um jedoch die Interoperabilität mit anderen Implementierungen von WS-Management Protokoll sicherzustellen, verwenden Sie die richtige Groß-/Kleinschreibung für die angeforderte Ressource im Ressourcen-URI. Die richtige Groß-/Kleinschreibung ist die vom Ressourcenanbieter definierte Schreibweise.

Ressourcen-URIs erfordern zwar keine Berücksichtigung der 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 Ressource instance ab. Wenn Sie beispielsweise nur die Version-Eigenschaft von Win32_OperatingSystem abrufen, ist die Verwendung eines Fragments erforderlich. Weitere Informationen zu Fragmenten finden Sie unter Hinzufügen eines Selektors zu einem ResourceLocator- oder IWSManResourceLocator-Objekt in Windows-Remoteverwaltung und WMI.

Gemäß XML- und XPath-Standards erzwingt das WMI-Plug-In die Groß-/Kleinschreibung für Fragmente und XML, die die Eingabeparameter für eine Methode definieren. Zur Unterstützung des XPath 1.0/Level 1-Standards ist die Groß-/Kleinschreibung erforderlich. Um WMI-Daten über WinRM abzurufen, bedeutet Groß-/Kleinschreibung, dass die Namen von WMI-Klassen, -Eigenschaften und -Methoden mit der Groß-/Kleinschreibung des Namens übereinstimmen müssen, der im WMI-Repository gefunden wurde.

Weitere Informationen finden Sie unter XPath-Syntax.

Beispiele für Empfindlichkeit bei Groß-/Kleinschreibung

Beispielsweise kann ein Skript, das die eigenschaft SECURITY_DESCRIPTOR aus einem instance der WMI-Win32_Service klasse abruft, nicht großbuchstaben für die Namen im Fragmentpfad verwenden, nur der URI. Das WinRM-WMI-Plug-In gibt einen Fehler für das folgende VBScript-Beispiel zurück, da die für FragmentPath bereitgestellte XPath-XML nicht die richtige Groß-/Kleinschreibung verwendet. Im WMI-Repository schreibt die Klasse "Win32_Service".

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 korrekte 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