URIs de recursos

Um URI de recurso é um identificador para um tipo distinto de operação ou valor de gestão utilizado por serviços de gestão que implementam o protocolo WS-Management. Um valor de gestão pode ser a temperatura dentro de um computador. Um exemplo de operação de gestão é iniciar um serviço parado ou definir uma quota de utilizadores de volume de disco.

Resource URI Format

Um URI consiste num prefixo e num caminho para um recurso, como mostrado no seguinte exemplo:

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

Esta especificação de esquema indica que o URI se baseia na versão 1 do protocolo oficial WS-Management e que o recurso é um Win32_LogicalDisk no namespace "root\cimv2" do repositório WMI. Os prefixos URI contêm uma especificação de esquema, como "schemas.microsoft.com/wbem/wsman/1/wmi", e um tipo específico de recurso, como Win32_LogicalDisk. Para mais informações sobre como identificar uma instância específica de uma classe WMI, consulte Windows Gestão Remota e WMI.

Para mais informações, consulte Prefixos URI.

Tipos de URIs de Recursos

Embora Windows Instrumentação de Gestão (WMI) seja a principal fonte de dados de gestão para sistemas operativos baseados em Windows, existem também outras fontes de esquemas de gestão.

A lista seguinte descreve vários tipos de URIs de recursos usados pela Gestão Remota do Windows:

Sensibilidade a maiúsculas e minúsculas

O plug-in WMI preserva o caso do URI de recurso recebido num pedido. No entanto, para garantir interoperabilidade com outras implementações do protocolo WS-Management, utilize-se o caso correto para o recurso solicitado no URI de recursos. O caso correto é a grafia definida pelo fornecedor do recurso.

Embora os URIs de recursos não necessitem de sensibilidade a maiúsculas minúsculas, o XML fragmentado sim. Um fragmento especifica apenas uma propriedade, em vez de todo o conjunto de propriedades de um recurso. No caso dos recursos WMI, a sintaxe do fragmento obtém uma propriedade de uma instância de recurso. Por exemplo, obter apenas a propriedade Version de Win32_OperatingSystem requer usar um fragmento. Para mais informações sobre fragmentos, consulte "Adicionar um seletor a um objeto ResourceLocator ou IWSManResourceLocator" em Windows Gestão Remota e WMI.

Seguindo as normas XML e XPath , o plug-in WMI aplica a sensibilidade a maiúsculas minúsculas para fragmentos e XML que define os parâmetros de entrada para um método. A sensibilidade a maiúsculas minúsculas é necessária para suportar o padrão XPath 1.0/Nível 1. Para obter dados WMI através do WinRM, a sensibilidade a maiúsculas minúsculas significa que os nomes das classes, propriedades e métodos WMI devem corresponder ao caso do nome encontrado no repositório WMI.

Para mais informações, consulte Sintaxe XPath.

Exemplos de Sensibilidade a Maiúsculas

Por exemplo, um script que obtém a propriedade SECURITY_DESCRIPTOR a partir de uma instância da classe WMI Win32_Service não pode usar maiúsculas para os nomes no caminho do fragmento, apenas para o URI. O plug-in WinRM WMI devolve um erro para o seguinte exemplo de VBScript porque o XPath XML fornecido para o FragmentPath não usa o caso correto. No repositório WMI, a classe é escrita como "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

A versão seguinte do mesmo exemplo mostra o uso correto do caso para a classe Win32_Service e a propriedade 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

Sobre Windows Gestão Remota

Gestão Remota de Hardware

ResourceLocator