Resource-URI's

Een resource-URI is een id voor een uniek type beheerbewerking of -waarde die wordt gebruikt door beheerservices die het WS-Management-protocol implementeren. Een beheerwaarde kan de temperatuur binnen een computer zijn. Een voorbeeld van een beheerbewerking is het starten van een gestopte service of het instellen van een gebruikersquotum voor schijfvolumes.

Resource-URI-indeling

Een URI bestaat uit een voorvoegsel en een pad naar een resource, zoals wordt weergegeven in het volgende voorbeeld:

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

Deze schemaspecificatie geeft aan dat de URI is gebaseerd op versie 1 van het officiële WS-Management protocol en dat de resource een Win32_LogicalDisk is in de naamruimte root\cimv2 van de WMI-opslagplaats. URI-voorvoegsels bevatten een schemaspecificatie, zoals 'schemas.microsoft.com/wbem/wsman/1/wmi' en een specifiek type resource, zoals Win32_LogicalDisk. Zie Windows Remote Management en WMI voor meer informatie over het identificeren van een specifiek exemplaar van een WMI-klasse.

Zie URI-voorvoegsels voor meer informatie.

Typen resource-URI's

Hoewel Windows Management Instrumentation (WMI) de primaire bron van beheergegevens is voor op Windows gebaseerde besturingssystemen, bestaan er ook andere beheerschemabronnen.

In de volgende lijst worden verschillende typen resource-URI's beschreven die worden gebruikt door Windows Extern beheer:

• WMI-URI's

  Deze groep URI's vertegenwoordigt een Common Information Model-klassepad dat naamruimte en klasse bevat.

  WMI-URI's kunnen worden gebruikt in:

  • Sessiemethoden
  • IWSManSession-methoden
  • WSMan.CreateResourceLocator- of IWSMan.CreateResourceLocator-methoden
  • ResourceLocator- of IWSManResourceLocator-methoden

• IPMI-URI's

  Deze groep URI's vertegenwoordigen industriestandaard-URI's op basis van CIM versie 2.9. IPMI-URI's kunnen worden gebruikt in sessiemethodenOphalen, Put, Enumerate en Invoke.

  Een voorbeeld is https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor.xsd. Deze resource wordt gedefinieerd volgens het DMTF.org CIM-schema.

• WinRM-configuratie-URI's

  Deze groep URI's zijn configuratiebewerkingen voor deWinRM-listenerconfiguratie .

  https://schemas.microsoft.com/wbem/wsman/1/config/listener kan worden gebruikt in sessiemethodenophalen, plaatsen, maken, verwijderen en opsommen.

• SEL-URI's (System Event Log)

  Deze groep URI's abonneert zich op gebeurtenisverzamelaar-gebeurtenissen van de BMC. U kunt zich abonneren op deze gebeurtenissen met behulp van het opdrachtregelprogramma Wevtutil .

Hoofdlettergevoeligheid

De WMI-invoegtoepassing behoudt het geval van de resource-URI die in een aanvraag is ontvangen. Als u echter wilt zorgen voor interoperabiliteit met andere implementaties van WS-Management protocol, gebruikt u de juiste case voor de aangevraagde resource in de resource-URI. Het juiste geval is de spelling die is gedefinieerd door de resourceprovider.

Resource-URI's vereisen geen hoofdlettergevoeligheid, maar fragment-XML wel. Een fragment geeft slechts één eigenschap op, in plaats van de hele set eigenschappen voor een resource. In het geval van WMI-resources krijgt fragmentsyntaxis één eigenschap van een resource-exemplaar. Als u bijvoorbeeld alleen de eigenschap Versie van Win32_OperatingSystem ophaalt, moet u een fragment gebruiken. Zie 'Een selector toevoegen aan een ResourceLocator- of IWSManResourceLocator-object' in Windows Extern beheer en WMI voor meer informatie over fragmenten.

Volgens xml- en XPath-standaarden dwingt de WMI-invoegtoepassing hoofdlettergevoeligheid af voor fragmenten en XML die de invoerparameters voor een methode definieert. Hoofdlettergevoeligheid is vereist om de XPath 1.0/Level 1-standaard te ondersteunen. Als u WMI-gegevens wilt ophalen via WinRM, betekent hoofdlettergevoeligheid dat de namen van WMI-klassen, eigenschappen en methoden moeten overeenkomen met het geval van de naam die in de WMI-opslagplaats is gevonden.

Zie XPath-syntaxis voor meer informatie.

Voorbeelden van hoofdlettergevoeligheid

Een script dat de eigenschap SECURITY_DESCRIPTOR verkrijgt van een exemplaar van de WMI-Win32_Service klasse kan bijvoorbeeld geen hoofdletters gebruiken voor de namen in het fragmentpad, alleen de URI. De WinRM WMI-invoegtoepassing retourneert een fout voor het volgende VBScript-voorbeeld omdat de XPath XML die is opgegeven voor FragmentPath niet de juiste case gebruikt. In de WMI-opslagplaats wordt de klasse gespeld als '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

In de volgende versie van hetzelfde voorbeeld ziet u het juiste gebruik van case voor de eigenschap Win32_Service klasse en 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

Verwante onderwerpen

Over Windows Extern beheer

Extern hardwarebeheer

ResourceLocator