Acessando uma coleção 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 iteração. A API de Scripts para WMI expõe várias interfaces que estão em conformidade com o paradigma de coleção. Em cada caso, use o método Item para identificar os elementos usando 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 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 WMI. O objeto SWbemNamedValueSet pode conter objetos WMI ou qualquer outro tipo de dados necessário para a chamada do 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. Em contraste, o PowerShell geralmente usa uma coleção de objetos implícita sempre que um valor retornado contém mais de um resultado.

 

A tabela a seguir lista as coleções na API de Scripts para WMI e os elementos e parâmetros para 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 sobre e exemplos de adição e remoção de itens de uma coleção, consulte Removendo um único item de uma coleção e removendo vários itens de uma coleção. Para obter mais informações sobre como trabalhar com classes, consulte Manipulando informações de classe e instância.