Configuration Manager speciale query's

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

Matrixeigenschap
Bepaalde waarden in een matrixeigenschap.

Basisklasse
Eigenschapswaarden die aanwezig zijn in een basisklasse.

Prototype
Een klassedefinitie in plaats van klassegegevens.

Verzamelingsbeperking
Gegevens die specifiek zijn voor een bepaalde verzameling.

Query's voor matrixeigenschappen

Vanwege de aard van matrixeigenschappen, kan het opnemen ervan in een uitgebreide WQL-query enigszins complex zijn. Denk bijvoorbeeld aan 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"

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

Basisklassequery's

Uitgebreide WQL-query's op een basisklasse retourneren exemplaren van alle subklassen. Voor abstracte basisklassequery's zijn de exemplaren die worden geretourneerd altijd exemplaren van de afgeleide klassen. De volgende query retourneert bijvoorbeeld exemplaren van 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 uitgebreide WQL kunt u aanvragen dat de resultatenset een definitie bevat van de klasse die moet worden geretourneerd in plaats van de werkelijke exemplaren van de klasse. Er zijn twee mogelijke resultaten van dit type query. In de meeste gevallen retourneert een prototypequery 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 meest nuttig zijn voor het verwerken van de resultaten van JOIN-bewerkingen, worden ze ondersteund voor alle query's. Als u een klassedefinitie wilt aanvragen als resultatenset, stelt u de lFlags parameter in of IWbemServices::ExecQueryAsync in IWbemServices::ExecQuery op WBEM_FLAG_PROTOTYPE.

Verzamelingsbeperkende query's

Een Configuration Manager-verzameling is een groepering van resources, zoals computers en gebruikers. Uitgebreide WQL ondersteunt query's voor bepaalde verzamelingen. Er zijn twee benaderingen die u kunt gebruiken om een query te beperken tot een bepaalde verzameling:

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

Geef een interne 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 het is de enige mogelijke aanpak als u een toepassing gebruikt die gebruikmaakt van de WMI ODBC-adapter.

Zie ook

Configuration Manager-koppelingsklassen
eigenschappen van Configuration Manager-bitsveld
Configuration Manager datum- en tijdnotaties
Ingesloten objecten Configuration Manager
uitgebreide WMI-querytaal Configuration Manager
Overzicht van objectenConfiguration Manager Luie eigenschappen
Over foutenConfiguration Manager Objectbeveiliging