Speciale query's voor Configuration Manager

Extended WMI Query Language (WQL) ondersteunt query's die specifiek zijn voor de behoeften van Configuration Manager. De volgende tabel beschrijft de aanvullende query's die worden ondersteund.

Matrixeigenschap Specifieke waarden in een matrixeigenschap.

Basisklasse Eigenschapswaarden die aanwezig zijn in een basisklasse.

Prototype Een klassedefinitie in plaats van klassegegevens.

Verzamelingsbeperkende gegevens die specifiek zijn voor een bepaalde verzameling.

Matrixeigenschapsquery's

Vanwege de aard van matrixeigenschappen kan het nogal ingewikkeld zijn om ze op te nemen in een uitgebreide WQL-query. Kijk bijvoorbeeld eens naar de SMS_R_System klasse die de IPAddresses eigenschap bevat. De IPAddresses eigenschap is een matrix die een of meer afzonderlijke adressen bevat. Als u een query wilt uitvoeren op computers met IP-adressen, kunt u een van de volgende twee query's opgeven.

SELECT * FROM SMS_R_System WHERE IPAddresses = "2.2.2.2"

SELECTEER * VAN SMS_R_System WAAR IPAddresses IN ("1.1.1.1", "2.2.2.2")

Basisklassequery's

Uitgebreide WQL-query's op een basisklasse retourneren exemplaren uit alle subklassen. Voor abstracte basisklassequery's zijn de exemplaren die worden geretourneerd altijd exemplaren van de afgeleide klassen. De volgende query retourneert bijvoorbeeld exemplaren uit klassen zoals SMS_SCI_Component en SMS_SCI_Address, die eigenschappen overnemen van SMS_SiteControlItem.

SELECT * FROM SMS_SiteControlItem WHERE Sitecode="ABC"

Prototypequery's

Met Extended WQL kunt u vragen of de resultaatset een definitie bevat van de klasse die moet worden geretourneerd in plaats van de feitelijke exemplaren van de klasse. Er zijn twee mogelijke resultaten van dit type query. In de meeste gevallen geeft een prototypequery als resultaat een klasseobject dat de definitie bevat. Als de query een JOIN-bewerking is met meerdere klassen in de SELECT-instructie, retourneert de prototypequery een exemplaar van de klasse __Generic.

Hoewel prototypequery's het nuttigst zijn bij het verwerken van de resultaten van JOIN-bewerkingen, worden ze voor alle query's ondersteund. Als u een klassedefinitie voor de resultatenset wilt aanvragen, stelt u de lFlags parameter in IWbemServices::ExecQuery of IWbemServices::ExecQueryAsync in op WBEM_FLAG_PROTOTYPE.

Verzamelingsbeperkende query's

Een Configuration Manager-verzameling is een groepering van bronnen, zoals computers en gebruikers. Extended WQL ondersteunt query's op bepaalde verzamelingen. U kunt een query op twee manieren beperken tot een bepaalde verzameling:

Stel de contextwaarde LimitToCollectionIDs in op de vereiste waarde voor CollectionID. Deze contextwaarde wordt beschikbaar gesteld via de IWbemContext-pointer in de IWbemServices::ExecQuery methode naar de naam van de verzameling.

Geef een binnenste JOIN-bewerking op met behulp van de SMS_CollectionMember-afgeleide klassen in de query die wordt doorgegeven aan ExecQuery.

De tweede benadering is langzamer, maar is de enige mogelijke benadering als u een toepassing gebruikt die gebruikmaakt van de WMI ODBC-adapter.

Zie ook

Configuration Manager AssociatieklassenConfiguration Manager bitveldeigenschappenConfiguration Manager datum- en tijdnotatiesConfiguration Manager ingesloten objectenConfiguration Manager overzicht van Extended WMI-querytaalobjectenConfiguration Manager Lazy PropertiesOver foutenConfiguration Manager Objectbeveiliging