Configuration Manager consultas especiais

A WQL (Linguagem de Consulta WMI Estendida) dá suporte a consultas específicas para Configuration Manager necessidades. A tabela a seguir descreve as consultas adicionais com suporte.

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

Classe base
Valores de propriedade existentes 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 propriedade array

Devido à natureza das propriedades da matriz, incluindo-as em uma consulta WQL estendida pode ser um pouco complexa. 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

Consultas WQL estendidas em instâncias de retorno de classe base de todas as subclasses. Para consultas de classe base abstratas, 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 solicitar 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 desse tipo de consulta. Para a 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 que limitam a coleção

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

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 usa o Adaptador ODBC do WMI.

Confira também

Classes de Associação Configuration Manager
propriedades do campo de Configuration Manager bit
formatos de data e hora Configuration Manager
Configuration Manager Objetos Incorporados
Configuration Manager Linguagem de Consulta WMI Estendida
Visão geral dos objetosConfiguration Manager Propriedades Preguiçosas
Sobre errosConfiguration Manager Segurança do Objeto