Acessar uma coleção do WMI

Uma coleção é um conceito de automação padrão que fornece uma interface uniforme para um conjunto de objetos sobre o qual você pode executar a iteração. A API de Scripts para WMI expõe várias interfaces compatíveis com o paradigma de coleção. Em cada caso, use o método Item para identificar os elementos com uma cadeia de caracteres que contém o valor.

As coleções SWbemPropertySet, SWbemQualifierSet e SWbemMethodSet são usadas principalmente para modificar o esquema. Um objeto SWbemObjectSet contém objetos do WMI, como uma instância de Win32_LogicalDisk, que foram obtidos por meio de chamadas, como SWbemServices.InstancesOf ou SWbemObject.Associators_. O objeto SWbemRefresher só pode conter instâncias de classes do WMI. O objeto SWbemNamedValueSet pode conter objetos do WMI ou qualquer outro tipo de dados que um provedor requer para a chamada de método.

Observação

Os tópicos a seguir foram escritos principalmente para VBScript. O C# usa a interface IEnumerable padrão para agrupar e enumerar objetos. Por outro lado, o PowerShell geralmente usa uma coleção de objetos implícitos sempre que um valor retornado contém mais de um resultado.

 

A tabela a seguir lista as coleções na API de Script para WMI e os elementos e parâmetros de cada coleção.

Coleção	Elemento	Parâmetro Item()
SWbemObjectSet	SWbemObject	Caminho do objeto
SWbemPropertySet	SWbemProperty	Nome da propriedade
SWbemQualifierSet	SWbemQualifier	Nome de qualificador
SWbemMethodSet	SWbemMethod	Nome do método
SWbemNamedValueSet	SWbemNamedValue	Nome do valor
SWbemPrivilegeSet	SWbemPrivilege	Nome do privilégio
SWbemRefresher	SWbemRefreshableItem	Índice do item no objeto SWbemRefresher

 

Para obter mais informações e exemplos de adição e remoção de itens de uma coleção, consulte Remover um único item de uma coleção e Remover vários itens de uma coleção. Para obter mais informações sobre como trabalhar com classes, consulte Manipular informações de classe e instância.