URI risorse

Un URI della risorsa è un identificatore per un tipo distinto di operazione di gestione o valore usato dai servizi di gestione che implementano il protocollo WS-Management. Un valore di gestione può essere la temperatura all'interno di un computer. Un esempio di operazione di gestione è l'avvio di un servizio arrestato o l'impostazione di una quota utente del volume del disco.

Formato URI risorsa

Un URI è costituito da un prefisso e da un percorso di una risorsa, come illustrato nell'esempio seguente:

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

Questa specifica dello schema indica che l'URI è basato sulla versione 1 del protocollo WS-Management ufficiale e che la risorsa è una Win32_LogicalDisk nello spazio dei nomi "root\cimv2" del repository WMI. I prefissi URI contengono una specifica dello schema, ad esempio "schemas.microsoft.com/wbem/wsman/1/wmi" e un tipo specifico di risorsa, ad esempio Win32_LogicalDisk. Per altre informazioni sull'identificazione di un'istanza specifica di una classe WMI, vedere Gestione remota Windows e WMI.

Per altre informazioni, vedere Prefissi URI.

Tipi di URI delle risorse

Anche se Strumentazione gestione Windows (WMI) è l'origine principale dei dati di gestione per i sistemi operativi basati su Windows, esistono anche altre origini dello schema di gestione.

L'elenco seguente descrive diversi tipi di URI di risorse usati da Gestione remota Windows:

• URI WMI

  Questo gruppo di URI rappresenta un percorso di classe Common Information Model che include spazio dei nomi e classe.

  Gli URI WMI possono essere usati in:

  • Metodi di sessione
  • Metodi IWSManSession
  • Metodi WSMan.CreateResourceLocator o IWSMan.CreateResourceLocator
  • Metodi ResourceLocator o IWSManResourceLocator

• URI IPMI

  Questo gruppo di URI rappresenta gli URI standard del settore basati su CIM versione 2.9. Gli URI IPMI possono essere usati nei metodi di sessioneGet, Put, Enumerate e Invoke.

  Un esempio è https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor.xsd. Questa risorsa viene definita in base allo schema CIM DMTF.org .

• URI di configurazione winRM

  Questo gruppo di URI sono operazioni di configurazione per la configurazione dellistener WinRM.

  https://schemas.microsoft.com/wbem/wsman/1/config/listener può essere usato nei metodi di sessioneGet, Put, Create, Delete ed Enumerate.

• URI del registro eventi di sistema (SEL)

  Questo gruppo di URI sottoscrive gli eventi dell'agente di raccolta eventi dal BMC. È possibile sottoscrivere questi eventi usando lo strumento da riga di comando Wevtutil .

Maiuscole/minuscole

Il plug-in WMI mantiene il caso dell'URI della risorsa ricevuto in una richiesta. Tuttavia, per garantire l'interoperabilità con altre implementazioni del protocollo WS-Management, usare il caso corretto per la risorsa richiesta nell'URI della risorsa. Il caso corretto è l'ortografia definita dal provider di risorse.

Anche se gli URI delle risorse non richiedono la distinzione tra maiuscole e minuscole, il frammento XML viene eseguito. Un frammento specifica una sola proprietà, anziché l'intero set di proprietà per una risorsa. Nel caso delle risorse WMI, la sintassi del frammento ottiene una proprietà da un'istanza della risorsa. Ad esempio, ottenere solo la proprietà Version da Win32_OperatingSystem richiede l'uso di un frammento. Per altre informazioni sui frammenti, vedere "Aggiunta di un selettore a un oggetto ResourceLocator o IWSManResourceLocator" in Gestione remota Windows e WMI.

Seguendo gli standard XML e XPath , il plug-in WMI applica la distinzione tra maiuscole e minuscole per frammenti e XML che definisce i parametri di input per un metodo. La distinzione tra maiuscole e minuscole è necessaria per supportare lo standard XPath 1.0/Level 1. Per ottenere dati WMI tramite WinRM, la distinzione tra maiuscole e minuscole indica che i nomi delle classi, delle proprietà e dei metodi WMI devono corrispondere al caso del nome trovato nel repository WMI.

Per altre informazioni, vedere Sintassi XPath.

Esempi di distinzione tra maiuscole e minuscole

Ad esempio, uno script che ottiene la proprietà SECURITY_DESCRIPTOR da un'istanza della classe wmi Win32_Service non può usare maiuscole per i nomi nel percorso del frammento, ma solo l'URI. Il plug-in WMI WinRM restituisce un errore per l'esempio VBScript seguente perché il codice XML XPath fornito per FragmentPath non usa il caso corretto. Nel repository WMI la classe viene digitata come "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

Nella versione seguente dello stesso esempio viene illustrato l'uso corretto del caso per la classe Win32_Service e la proprietà 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

Argomenti correlati

Informazioni su Gestione remota Windows

Gestione hardware remota

ResourceLocator