URI de ressource
Un URI de ressource est un identificateur d’un type distinct d’opération ou de valeur de gestion utilisé 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 consiste à démarrer un service arrêté ou à définir un quota d’utilisateur de volume de disque.
Format de l’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 WS-Management officiel et que la ressource est un Win32_LogicalDisk dans l’espace de noms « root\cimv2 » du dépôt WMI. Les préfixes URI contiennent une spécification de schéma, telle que « schemas.microsoft.com/wbem/wsman/1/wmi » et un type de ressource spécifique, comme Win32_LogicalDisk. Pour plus d’informations sur l’identification d’un 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 ressource
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 de classe Common Information Model qui inclut l’espace de noms et la classe.
Les URI WMI peuvent être utilisés dans :
URI IPMI
Ce groupe d’URI représente les URI standard du secteur basés sur cim version 2.9. Les URI IPMI peuvent être utilisés dans les méthodes de sessionGet, Put, Enumerate et Invoke.
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 sont des opérations de configuration pour la configuration del’écouteur WinRM.
https://schemas.microsoft.com/wbem/wsman/1/config/listenerpeut être utilisé dans les méthodes Session Get, Put, Create, Delete et Enumerate.URI du journal des événements système (SEL)
Ce groupe d’URI s’abonne aux événements du collecteur d’événements à partir du 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 de WS-Management protocole, utilisez le cas correct 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, le xml du fragment n’en est pas moins le cas. 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é à partir d’une ressource instance. Par exemple, l’obtention de la propriété Version uniquement à 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.
Suivant les normes XML et XPath , le plug-in WMI applique le respect de la casse pour les fragments et xml qui définit les paramètres d’entrée d’une méthode. Le respect de la casse est requis pour prendre en charge la norme XPath 1.0/Level 1. Pour obtenir des données WMI via WinRM, le respect de la casse signifie que les noms des classes, propriétés et méthodes WMI doivent correspondre à la casse du nom trouvé dans le référentiel WMI.
Pour plus d’informations, consultez Syntaxe XPath.
Exemples de respect de la casse
Par exemple, un script qui obtient la propriété SECURITY_DESCRIPTOR à partir d’une instance de la classe Win32_Service WMI ne peut pas utiliser la majuscule pour les noms dans le chemin d’accès du fragment, uniquement l’URI. Le plug-in WMI WinRM retourne une erreur pour l’exemple VBScript suivant, car le code XML XPath fourni pour FragmentPath n’utilise pas le cas correct. Dans le référentiel WMI, la classe est orthographiée « 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 du même exemple montre l’utilisation correcte de la casse 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