URIs do Recurso
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:
WMI URIs
Esse grupo de URIs representa um caminho de classe do Modelo de Informações Comuns que inclui namespace e classe.
As URIs WMI podem ser usadas em:
IPMI URIs
Esse grupo de URIs representa URIs padrão do setor com base no CIM versão 2.9. URIs IPMI podem ser usados em Métodos de sessãoGet, Put, Enumerar e Invoke.
Um exemplo é https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor.xsd. Esse recurso é definido de acordo com o esquema CIM DMTF.org .
URIs de configuração do WinRM
Esse grupo de URIs são operações de configuração para a configuração doouvinte WinRM.
https://schemas.microsoft.com/wbem/wsman/1/config/listenerpode ser usado em Métodos de sessãoGet, Put, Create, Delete e Enumerate.URIs do SEL (Log de Eventos do Sistema)
Esse grupo de URIs assina eventos do Coletor de Eventos do BMC. Você pode assinar esses eventos usando a ferramenta de linha de comando Wevtutil .
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
Tópicos relacionados