URIs do Recurso

  • Artigo

Um URI de recurso é um identificador para um tipo distinto de operação de gerenciamento ou valor usado pelos serviços de gerenciamento que implementam o protocolo WS-Management. Um valor de gerenciamento pode ser a temperatura dentro de um computador. Um exemplo de uma operação de gerenciamento é iniciar um serviço interrompido ou definir uma cota de usuário de volume de disco.

Formato de URI do recurso

Um URI consiste em um prefixo e um caminho para um recurso, conforme mostrado no exemplo a seguir:

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

Essa especificação de esquema indica que o URI é baseado 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 de 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 obter mais informações sobre como identificar uma instância específica de uma classe WMI, consulte Gerenciamento Remoto do Windows e WMI.

Para obter mais informações, consulte Prefixos de URI.

Tipos de URIs de Recurso

Embora a WMI (Instrumentação de Gerenciamento do Windows) seja a principal fonte de dados de gerenciamento para sistemas operacionais baseados no Windows, outras fontes de esquema de gerenciamento também existem.

A lista a seguir descreve vários tipos de URIs de recurso usados pelo Gerenciamento Remoto do Windows:

Diferenciação de maiúsculas e minúsculas

O plug-in WMI preserva o caso do URI de recurso recebido em uma solicitação. No entanto, para garantir a interoperabilidade com outras implementações do protocolo WS-Management, use o caso correto para o recurso solicitado no URI do recurso. O caso correto é a ortografia definida pelo provedor de recursos.

Embora os URIs de recurso não exijam diferenciação de maiúsculas e minúsculas, o XML de fragmento exige. Um fragmento especifica apenas uma propriedade, em vez de todo o conjunto de propriedades de um recurso. No caso de recursos WMI, a sintaxe de fragmento obtém uma propriedade de uma instância de recurso. Por exemplo, obter apenas a propriedade Version de Win32_OperatingSystem requer o uso de um fragmento. Para obter mais informações sobre fragmentos, consulte "Como adicionar um seletor a um objeto ResourceLocator ou IWSManResourceLocator" no Gerenciamento Remoto do Windows e WMI.

Seguindo os padrões XML e XPath , o plug-in WMI impõe a confidencialidade de maiúsculas e minúsculas para fragmentos e XML que define os parâmetros de entrada para um método. A diferenciação de maiúsculas e minúsculas é necessária para dar suporte ao padrão XPath 1.0/Nível 1. Para obter dados WMI por meio do WinRM, a diferenciação de maiúsculas e minúsculas significa que os nomes de classes, propriedades e métodos WMI devem corresponder ao caso do nome encontrado no repositório WMI.

Para obter mais informações, consulte Sintaxe XPath.

Exemplos de confidencialidade de maiúsculas e minúsculas

Por exemplo, um script que obtém a propriedade SECURITY_DESCRIPTOR de uma instância da classe Win32_Service WMI não pode usar maiúsculas para os nomes no caminho do fragmento, apenas o URI. O plug-in WMI do WinRM retorna um erro para o exemplo VBScript a seguir porque o XML XPath 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 a seguir do mesmo exemplo mostra o uso correto de maiúsculas e minúsculas 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 o Gerenciamento Remoto do Windows

Gerenciamento remoto de hardware

Resourcelocator