Descrever a localização de um objeto WMI

Conceitualmente semelhante a uma URL (Uniform Resource Locator), um caminho de objeto WMI é uma cadeia de caracteres que identifica exclusivamente o namespace em um servidor, em uma classe dentro de um namespace ou em instâncias de uma classe. Um caminho de objeto é hierárquico e contém vários elementos que descrevem o local do objeto em questão. Assim como os caminhos de arquivo, os caminhos de objeto WMI podem ser descritos na íntegra ou especificados como um caminho relativo.

O namespace de um objeto WMI está listado na página de referência do WMI. Por exemplo, o local da maioria das classes com suporte pelos Provedores CIMWin32 do WMI está localizado no namespace \root\cimv2. O código do PowerShell a seguir descreve uma chamada para recuperar o objeto Win32_ComputerSystem em seu computador local:

Get-WmiObject -Class Win32_ComputerSystem -Namespace "root\cimv2" -ComputerName "."

Como alternativa, uma instância específica do Win32_LogicalDisk pode ter o seguinte caminho da propriedade SWbemObject.Path_.

\\Machine1\root\cimv2:Win32_LogicalDisk.DeviceID="C:"

O exemplo a seguir mostra o caminho relativo para essa instância, conforme visto ao exibir a propriedade Relpath do objeto SWbemObjectPath retornado pela chamada a SWbemObject.Path_.

Win32_LogicalDisk.DeviceID="A:"

Observe que DeviceID é a propriedade de chave da classe Win32_LogicalDisk.

C++

A tabela a seguir lista os tipos de caminho de objeto e os métodos associados que exigem caminhos de objeto.

Tipo de caminho de objeto Método
Namespace
IWbemServices::OpenNamespace
Classe
IWbemServices::ExecMethod
[IWbemServices::ExecMethodAsync](/windows/desktop/api/WbemCli/nf-wbemcli-iwbemservices-execmethodasync)
Classe ou Instância
IWbemServices::GetObject
[IWbemServices::GetObjectAsync](/windows/desktop/api/WbemCli/nf-wbemcli-iwbemservices-getobjectasync)
Instância
IWbemServices::DeleteInstance
[IWbemServices::DeleteInstanceAsync](/windows/desktop/api/WbemCli/nf-wbemcli-iwbemservices-deleteinstanceasync)

 

Script

Os caminhos de objeto podem ser construídos de várias maneiras:

  • Recupera a propriedade de um método que retorna um objeto SWbemObjectPath.
  • Recupera a propriedade SWbemObject.Path_.
  • Cria uma variável de cadeia de caracteres que contém o caminho do objeto.

A tabela a seguir lista os objetos de script que exigem caminhos de objeto.

Gerar scripts de objetos Método
SWbemServices
AssociatorsOf
[AssociatorsOfAsync](swbemservices-associatorsofasync.md)
[Delete](swbemservices-delete.md)
[DeleteAsync](swbemservices-deleteasync.md)
[ExecMethod](swbemservices-execmethod.md)
[ExecMethodAsync](swbemservices-execmethodasync.md)
[Get](swbemservices-get.md)
[GetAsync](swbemservices-getasync.md)
[ReferencesTo](swbemservices-referencesto.md)
[ReferencesToAsync](swbemservices-referencestoasync.md)
SWbemObjectSet
Item