URI de ressource

Un URI de ressource est un identificateur d’un type distinct d’opération de gestion ou de valeur utilisée par les services de gestion qui implémentent le protocole WS-Management. Une valeur de gestion peut être la température à l’intérieur d’un ordinateur. Un exemple d’opération de gestion démarre un service arrêté ou définit un quota d’utilisateur de volume de disque.

Format d’URI de ressource

Un URI se compose d’un préfixe et d’un chemin d’accès à une ressource, comme illustré dans l’exemple suivant :

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

Cette spécification de schéma indique que l’URI est basé sur la version 1 du protocole officiel WS-Management et que la ressource est un Win32_LogicalDisk dans l’espace de noms « root\cimv2 » du référentiel WMI. Les préfixes d’URI contiennent une spécification de schéma, telle que « schemas.microsoft.com/wbem/wsman/1/wmi » et un type spécifique de ressource, tel que Win32_LogicalDisk. Pour plus d’informations sur l’identification d’une instance spécifique d’une classe WMI, consultez Gestion à distance Windows et WMI.

Pour plus d’informations, consultez préfixes d’URI.

Types d’URI de ressources

Bien que windows Management Instrumentation (WMI) soit la principale source de données de gestion pour les systèmes d’exploitation Windows, d’autres sources de schéma de gestion existent également.

La liste suivante décrit plusieurs types d’URI de ressources utilisés par la gestion à distance windows :

• URI WMI

  Ce groupe d’URI représente un chemin d’accès de classe Common Information Model qui inclut l’espace de noms et la classe.

  Les URI WMI peuvent être utilisés dans :

  • méthodes de session
  • méthodes IWSManSession
  • méthodes WSMan.CreateResourceLocator ou IWSMan.CreateResourceLocator
  • méthodes ResourceLocator ou IWSManResourceLocator

• URI IPMI

  Ce groupe d’URI représente des URI standard du secteur basés sur CIM version 2.9. Les URI IPMI peuvent être utilisés dans les méthodes SessionGet, Put, Énumérer et Appeler.

  Par exemple, https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor.xsd. Cette ressource est définie en fonction du schéma CIM DMTF.org.

• URI de configuration WinRM

  Ce groupe d’URI est des opérations de configuration pour la configuration de l’écouteur WinRM.

  https://schemas.microsoft.com/wbem/wsman/1/config/listener pouvez être utilisé dans les méthodessessionGet, Put, Create, Deleteet Énumérer.

• URI du journal des événements système(SEL)

  Ce groupe d’URI s’abonne aux événements Event Collector à partir de la console BMC. Vous pouvez vous abonner à ces événements à l’aide de l’outil en ligne de commande Wevtutil.

Respect de la casse

Le plug-in WMI conserve le cas de l’URI de ressource reçu dans une requête. Toutefois, pour garantir l’interopérabilité avec d’autres implémentations du protocole WS-Management, utilisez le cas approprié pour la ressource demandée dans l’URI de ressource. Le cas correct est l’orthographe définie par le fournisseur de ressources.

Bien que les URI de ressource ne nécessitent pas de respect de la casse, fragment XML. Un fragment spécifie une seule propriété, plutôt que l’ensemble entier des propriétés d’une ressource. Dans le cas des ressources WMI, la syntaxe de fragment obtient une propriété d’une instance de ressource. Par exemple, l’obtention uniquement de la propriété Version à partir de Win32_OperatingSystem nécessite l’utilisation d’un fragment. Pour plus d’informations sur les fragments, consultez « Ajout d’un sélecteur à un objet ResourceLocator ou IWSManResourceLocator » dans Gestion à distance Windows et WMI.

À la suite de normes xml et XPath, le plug-in WMI applique la sensibilité à la casse pour les fragments et xml qui définissent les paramètres d’entrée d’une méthode. La sensibilité à la casse est requise pour prendre en charge la norme XPath 1.0/Level 1. Pour obtenir des données WMI via WinRM, la sensibilité à la casse signifie que les noms des classes, propriétés et méthodes WMI doivent correspondre au cas du nom trouvé dans le référentiel WMI.

Pour plus d’informations, consultez syntaxe XPath.

Exemples de confidentialité de cas

Par exemple, un script qui obtient la propriété SECURITY_DESCRIPTOR à partir d’une instance de la classe WMI Win32_Service ne peut pas utiliser les majuscules pour les noms dans le chemin du fragment, seul l’URI. Le plug-in WMI WinRM retourne une erreur pour l’exemple VBScript suivant, car le code XML XPath fourni pour le FragmentPath n’utilise pas le cas approprié. Dans le référentiel WMI, la classe est orthographié « 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

La version suivante de l’exemple montre l’utilisation correcte de cas pour la classe Win32_Service et la propriété 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

Rubriques connexes

à propos des de gestion à distance Windows

gestion matérielle à distance

ResourceLocator