Consultas Especiais do Configuration Manager

A WQL (Extended WMI Query Language) dá suporte a consultas específicas para necessidades do Configuration Manager. A tabela a seguir descreve as consultas adicionais com suporte.

Propriedade de matriz Valores específicos em uma propriedade de matriz.

Classe base Valores de propriedade que existem em uma classe base.

Protótipo Uma definição de classe em vez de dados de classe.

Limitação de coleção Dados específicos de uma coleção específica.

Consultas de propriedades de matriz

Devido à natureza das propriedades da matriz, incluí-las em uma consulta WQL estendida pode ser um pouco complexo. Por exemplo, considere a SMS_R_System classe que inclui a IPAddresses propriedade. A IPAddresses propriedade é uma matriz que contém um ou mais endereços individuais. Para consultar computadores com endereços IP, você pode especificar uma das duas consultas a seguir.

SELECT * FROM SMS_R_System WHERE IPAddresses = "2.2.2.2"

SELECT * FROM SMS_R_System WHERE IPAddresses IN ("1.1.1.1", "2.2.2.2")

Consultas de classe base

As consultas WQL estendidas em uma classe base retornam instâncias de todas as subclasses. Para consultas abstratas de classe base, as instâncias retornadas são sempre instâncias das classes derivadas. Por exemplo, a consulta a seguir retorna instâncias de classes como SMS_SCI_Component e SMS_SCI_Address, que herdam propriedades de SMS_SiteControlItem.

SELECT * FROM SMS_SiteControlItem WHERE Sitecode="ABC"

Consultas de Protótipo

O WQL estendido permite que você solicite que o conjunto de resultados contenha uma definição da classe a ser retornada em vez das instâncias reais da classe. Há dois resultados possíveis para esse tipo de consulta. Na maioria dos casos, uma consulta de protótipo retorna um objeto de classe que contém a definição. Se a consulta for uma operação JOIN com várias classes na instrução SELECT, a consulta de protótipo retornará uma instância da classe __Generic.

Embora as consultas de protótipo sejam mais úteis no processamento dos resultados das operações JOIN, elas têm suporte para todas as consultas. Para solicitar uma definição de classe como o conjunto de resultados, defina o lFlags parâmetro em IWbemServices::ExecQuery ou IWbemServices::ExecQueryAsync para WBEM_FLAG_PROTOTYPE.

Consultas limitantes de coleção

Uma coleção do Configuration Manager é um agrupamento de recursos, como computadores e usuários. O WQL estendido dá suporte a consultas em coleções específicas. Há duas abordagens que você pode usar para limitar uma consulta a um conjunto específico:

Defina o valor de contexto LimitToCollectionIDs como o valor CollectionID necessário. Esse valor de contexto é disponibilizado por meio do ponteiro IWbemContext no IWbemServices::ExecQuery método para o nome da coleção.

Especifique uma operação JOIN interna usando as SMS_CollectionMemberclasses derivadas na consulta que é passada para ExecQuery.

A segunda abordagem é mais lenta, mas é a única abordagem possível se você usar um aplicativo que use o adaptador ODBC WMI.

Confira também

Classes de Associação do Configuration ManagerPropriedades do Campo de Bits do Configuration ManagerFormatos de Data e Hora do Configuration ManagerObjetosIncorporados do Configuration ManagerVisão geral de objetos da linguagem de consulta WMI estendida do Configuration Manager do Configuration Manager Propriedades preguiçosasSobre errosSegurançade objetos do Configuration Manager