Ressourcen-URIs

Ein Ressourcen-URI ist ein Bezeichner für einen unterschiedlichen 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 Datenträgervolume-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 Management Instrumentation (WMI) die primäre Quelle für Verwaltungsdaten für Windows-basierte Betriebssysteme ist, gibt es auch andere Quellen des Verwaltungsschemas.

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

Groß- und Kleinschreibung

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

Ressourcen-URIs erfordern zwar keine Berücksichtigung der Kleinschreibung, fragmentierte XML-Daten hingegen nicht. Ein Fragment gibt nur eine Eigenschaft anstelle des gesamten Eigenschaftensatzes für eine Ressource an. Bei WMI-Ressourcen ruft die Fragmentsyntax eine Eigenschaft aus einer Ressourceninstanz ab. Um beispielsweise nur die Version-Eigenschaft von Win32 _ OperatingSystem zu erhalten, muss ein Fragment verwendet werden. Weitere Informationen zu Fragmenten finden Sie unter "Hinzufügen eines Selektors zu einem ResourceLocator- oder IWSManResourceLocator-Objekt" in Windows Remoteverwaltung und WMI.

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

Weitere Informationen finden Sie unter XPath-Syntax.

Beispiele für die Empfindlichkeit von Kleinschreibung

Beispielsweise kann ein Skript, das die SECURITY _ DESCRIPTOR-Eigenschaft von einer Instanz der WMI Win32 _ Service-Klasse erhält, keine Großbuchstaben für die Namen im Fragmentpfad verwenden, sondern nur den URI. Das WinRM-WMI-Plug-In gibt einen Fehler für das folgende VBScript-Beispiel zurück, da die für FragmentPath angegebene XPath-XML-Datei nicht die richtige Schreibung verwendet. Im WMI-Repository hat die Klasse die Schreibweise "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 des gleichen Beispiels zeigt die richtige Verwendung der Case-Klasse für die _ Win32-Dienstklasse und die 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 Windows Remoteverwaltung

Remotehardwareverwaltung

Resourcelocator