URI de recursos

Un URI de recursos es un identificador para un tipo distinto de operación de administración o valor utilizado por los servicios de administración que implementan el protocolo WS-Management. Un valor de administración podría ser la temperatura dentro de un equipo. Un ejemplo de una operación de administración es iniciar un servicio detenido o establecer una cuota de usuario de volumen de disco.

Formato de URI de recursos

Un URI consta de un prefijo y una ruta de acceso a un recurso, como se muestra en el ejemplo siguiente:

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

Esta especificación de esquema indica que el URI se basa en la versión 1 del protocolo oficial de WS-Management y que el recurso es un Win32_LogicalDisk en el espacio de nombres "root\cimv2" del repositorio WMI. Los prefijos de URI contienen una especificación de esquema, como "schemas.microsoft.com/wbem/wsman/1/wmi" y un tipo específico de recurso, como Win32_LogicalDisk. Para obtener más información sobre cómo identificar una instancia específica de una clase WMI, consulta Administración remota de Windows y WMI.

Para obtener más información, consulte Prefijos de URI.

Tipos de URI de recursos

Aunque Instrumental de administración de Windows (WMI) es el origen principal de datos de administración para sistemas operativos basados en Windows, también existen otros orígenes de esquema de administración.

En la lista siguiente se describen varios tipos de URI de recursos usados por la administración remota de Windows:

• URI de WMI

  Este grupo de URI representa una ruta de acceso de clase common Information Model que incluye el espacio de nombres y la clase .

  Los URI de WMI se pueden usar en:

  • Métodos de sesión
  • Métodos IWSManSession
  • Métodos WSMan.CreateResourceLocator o IWSMan.CreateResourceLocator
  • Métodos ResourceLocator o IWSManResourceLocator

• URI de IPMI

  Este grupo de URI representa los URI estándar del sector basados en la versión 2.9 de CIM. Los URI de IPMI se pueden usar en métodos de sesiónGet, Put, Enumerate e Invoke.

  Un ejemplo es https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor.xsd. Este recurso se define según el esquema CIM de DMTF.org .

• URI de configuración de WinRM

  Este grupo de URI son operaciones de configuración para la configuración delagente de escucha de WinRM.

  https://schemas.microsoft.com/wbem/wsman/1/config/listener se puede usar en los métodos SessionGet, Put, Create, Delete y Enumerate.

• URI del registro de eventos del sistema (SEL)

  Este grupo de URI se suscribe a eventos del recopilador de eventos de BMC. Puede suscribirse a estos eventos mediante la herramienta de línea de comandos Wevtutil .

Distinción entre mayúsculas y minúsculas

El complemento WMI conserva el caso del URI del recurso recibido en una solicitud. Sin embargo, para garantizar la interoperabilidad con otras implementaciones del protocolo de WS-Management, use el caso correcto para el recurso solicitado en el URI del recurso. El caso correcto es la ortografía definida por el proveedor de recursos.

Aunque los URI de recursos no requieren distinción entre mayúsculas y minúsculas, sí lo hace el XML de fragmento . Un fragmento especifica solo una propiedad, en lugar del conjunto completo de propiedades de un recurso. En el caso de los recursos WMI, la sintaxis de fragmento obtiene una propiedad de una instancia de recurso. Por ejemplo, obtener solo la propiedad Version de Win32_OperatingSystem requiere el uso de un fragmento. Para obtener más información sobre los fragmentos, vea "Agregar un selector a un objeto ResourceLocator o IWSManResourceLocator" en Administración remota de Windows y WMI.

Siguiendo los estándares XML y XPath , el complemento WMI aplica la distinción entre mayúsculas y minúsculas para fragmentos y XML que define los parámetros de entrada de un método. Se requiere distinción entre mayúsculas y minúsculas para admitir el estándar XPath 1.0/Level 1. Para obtener datos de WMI a través de WinRM, la distinción entre mayúsculas y minúsculas significa que los nombres de las clases, propiedades y métodos de WMI deben coincidir con el caso del nombre que se encuentra en el repositorio WMI.

Para obtener más información, vea Sintaxis XPath.

Ejemplos de distinción de mayúsculas y minúsculas

Por ejemplo, un script que obtiene la propiedad SECURITY_DESCRIPTOR de una instancia de la clase Win32_Service WMI no puede usar mayúsculas para los nombres de la ruta de acceso del fragmento, solo el URI. El complemento WMI de WinRM devuelve un error para el siguiente ejemplo de VBScript porque el XML XPath proporcionado para FragmentPath no usa el caso correcto. En el repositorio WMI, la clase se escribe "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

En la versión siguiente del mismo ejemplo se muestra el uso correcto de mayúsculas y minúsculas para la clase Win32_Service y la propiedad 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

Temas relacionados

Acerca de la administración remota de Windows

Administración remota de hardware

ResourceLocator