Dela via

Resurs-URI:er

  • Artikel

En resurs-URI är en identifierare för en distinkt typ av hanteringsåtgärd eller värde som används av hanteringstjänster som implementerar WS-Management-protokollet. Ett hanteringsvärde kan vara temperaturen i en dator. Ett exempel på en hanteringsåtgärd är att starta en stoppad tjänst eller ange en användarkvot för diskvolym.

Resurs-URI-format

En URI består av ett prefix och en sökväg till en resurs som visas i följande exempel:

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

Den här schemaspecifikationen anger att URI:n baseras på version 1 av det officiella WS-Management-protokollet och att resursen är en Win32_LogicalDisk i namnområdet "root\cimv2" på WMI-lagringsplatsen. URI-prefix innehåller en schemaspecifikation, till exempel "schemas.microsoft.com/wbem/wsman/1/wmi" och en viss typ av resurs, till exempel Win32_LogicalDisk. Mer information om hur du identifierar en specifik instans av en WMI-klass finns i Windows Remote Management och WMI.

Mer information finns i URI-prefix.

Typer av resurs-URI:er

Även om Windows Management Instrumentation (WMI) är den primära källan för hanteringsdata för Windows-baserade operativsystem, finns det även andra källor till hanteringsschema.

I följande lista beskrivs flera typer av resurs-URI:er som används av Windows Remote Management:

Skiftlägeskänslighet

WMI-plugin-programmet bevarar fallet med resurs-URI:n som tas emot i en begäran. Men för att säkerställa samverkan med andra implementeringar av WS-Management protokoll använder du rätt fall för den begärda resursen i resurs-URI. Rätt fall är den stavning som definieras av resursprovidern.

Resurs-URI:er kräver inte skiftlägeskänslighet, men fragment XML gör det. Ett fragment anger bara en egenskap i stället för hela uppsättningen egenskaper för en resurs. När det gäller WMI-resurser hämtar fragmentsyntaxen en egenskap från en resursinstans. Om du till exempel bara hämtar egenskapen Version från Win32_OperatingSystem måste du använda ett fragment. Mer information om fragment finns i "Lägga till en väljare i ett ResourceLocator- eller IWSManResourceLocator-objekt" i Windows Remote Management och WMI.

Efter XML- och XPath- standarder tillämpar WMI-plugin- skiftlägeskänslighet för fragment och XML som definierar indataparametrarna för en metod. Skiftlägeskänslighet krävs för att stödja XPath 1.0/Level 1-standarden. För att hämta WMI-data via WinRM innebär skiftlägeskänslighet att namnen på WMI-klasser, egenskaper och metoder måste matcha fallet med namnet som finns på WMI-lagringsplatsen.

Mer information finns i XPath-syntax.

Exempel på skiftlägeskänslighet

Ett skript som till exempel hämtar egenskapen SECURITY_DESCRIPTOR från en instans av klassen WMI Win32_Service kan inte använda versaler för namnen i fragmentsökvägen, bara URI:n. WinRM-WMI-plugin- returnerar ett fel för följande VBScript-exempel eftersom XPath XML som angetts för FragmentPath- inte använder rätt skiftläge. I WMI-lagringsplatsen stavas klassen "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

Följande version av samma exempel visar korrekt användning av skiftläge för Win32_Service-klassen och egenskapen SECURITY_DESCRIPTOR.

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

Om Windows Remote Management

Hantering av fjärrmaskinvara

ResourceLocator