Configuration Manager Context Qualifiers

Artikel
04/04/2023

Contextobjecten worden in Configuration Manager gebruikt om aanvullende informatie te verstrekken aan de SMS-provider. Normaal gesproken gebruikt u contextkwalificaties om de SMS-provider contextuele informatie te geven, zoals de naam van uw toepassing. U kunt contextkwalificaties gebruiken wanneer u verbinding maakt met de SMS-provider en met afzonderlijke SMS-providerobjecten.

Beheerde code

Wanneer u de beheerde SMS-providerbibliotheken gebruikt, gebruikt u de eigenschap ConnectionManagerBase.Context om contextkwalificaties op te geven. Zie How to Add a Configuration Manager Context Qualifier by Using Managed Code (Een Configuration Manager-contextkwalificatie toevoegen met behulp van beheerde code) voor meer informatie.

VBScript

Wanneer u VBScript gebruikt, gebruikt u de interface SWBemNamedValue om contextkwalificaties op te geven als een verzameling benoemde waardeobjecten. Zie How to Add a Configuration Manager Context Qualifier by Using WMI (Een Configuration Manager-contextkwalificatie toevoegen met behulp van WMI) voor meer informatie.

Contextkwalificaties

De volgende tabel bevat de contextkwalificaties (benoemde waarden) die worden gebruikt door de SMS-provider. De meeste kwalificaties, zoals SessionHandle, worden alleen gebruikt met specifieke functionele gebieden van de SMS-provider; maar LocaleID, MachineNameen ApplicationName zijn voor gebruik van uw toepassing.

Contextkwalificatie	Beschrijving
`ApplicationName`	Identificeert de toepassing die de aanroep heeft uitgevoerd.
`ContextHandle`	Identificeert waar de SMS-provider uw contextkwalificaties in de cache heeft opgeslagen.
`InstanceCount`	Hiermee wordt het aantal exemplaren beperkt dat wordt geretourneerd door ExecQuery en CreateInstanceEnum.
`LimitToCollectionIDs`	Beperkt de resultaten van een resourcequery tot de leden van de benoemde verzamelingen.
`LocaleID`	Identificeert de codepagina die moet worden gebruikt.
`MachineName`	Identificeert op welke computer de toepassing wordt uitgevoerd.
`QueryQualifiers`	Retourneert de SecurityVerbs-bitvlaggen wanneer u query's uitvoert op beveiligde objecten.
`SessionHandle`	Identificeert de kopie van uw toepassing van het sitebeheerbestand naar Configuration Manager.

ApplicationName

De ApplicationName contextkwalificatie is een tekenreekswaarde die de naam identificeert van de toepassing die de aanroep heeft gedaan. U moet opgeven ApplicationName voor uw toepassing omdat deze wordt gebruikt voor controle. Als u de naam van uw toepassing niet opgeeft, wordt de waarde Onbekend gebruikt. U moet de ApplicationName waarde opgeven wanneer u een van de methoden voor het genereren van statusberichten aanroept, zoals SMS_StatusMessage::RaiseErrorStatusMsg, anders mislukt de aanroep.

ContextHandle

De ContextHandle contextkwalificatie is een tekenreekswaarde die aangeeft waar de SMS-provider uw contextkwalificaties in de cache heeft opgeslagen. De beheerde SMS-provider beheert de gegevensoverdracht. Wanneer u VBScript gebruikt, kunt u de volgende stappen gebruiken om de hoeveelheid gegevens te verminderen die via het netwerk wordt doorgegeven.

Maak de waardeset SWBemNamedValue .
Voeg uw kwalificaties toe aan het contextobject. Zie How to Add a Configuration Manager Context Qualifier by Using WMI (Een Configuration Manager-contextkwalificatie toevoegen met behulp van WMI) voor meer informatie.
Roep de methode GetContextHandle aan om uw kwalificatie op de server in de cache te plaatsen. De SMS-provider slaat het contextobject op dat u doorgeeft als een parameter van ExecMethod wanneer u GetContextHandle aanroept.
Verwijder alle kwalificaties uit uw contextobject.
Voeg de ContextHandle kwalificatie en waarde toe aan uw contextobject.
Geef het contextobject voor alle aanroepen door aan IWbemServices.

U moet de ClearContextHandle-methode aanroepen om uw kwalificatie in de cache te verwijderen voordat u uw toepassing afsluit. U kunt zoveel ContextHandle waarden maken als u wilt, waarbij elke waarde verschillende informatie voor uw toepassing oplevert.

Opmerking

Nadat u uw contextkwalificaties in de cache hebt opgeslagen, kunt u de waarden in de cache overschrijven door dezelfde contextkwalificaties, met verschillende waarden, toe te voegen aan uw contextobject.

InstanceCount

De InstanceCount contextkwalificatie is een geheel getal dat wordt gebruikt om het aantal exemplaren te beperken dat wordt geretourneerd door de methoden ExecQuery en CreateInstanceEnum . U stelt InstanceCount gelijk in op het maximum aantal exemplaren dat u wilt retourneren vanuit de query of opsomming. Als u InstanceCount bijvoorbeeld instelt op 10, retourneert u maximaal 10 exemplaren.

LimitToCollectionID's

De LimitToCollectionIDs contextkwalificatie is een tekenreeksmatrix die een lijst met CollectionID waarden bevat. Op dit moment kunt u slechts één CollectionID waarde opgeven. U gebruikt deze kwalificatie om de resultaten van een resourcequery te beperken tot de leden van de benoemde verzameling. Een resourcequery is een query die klassen bevat die zijn afgeleid van SMS_Resource of SMS_Group.

De gebruiker moet machtigingen voor instantie-leesresources hebben voor de verzameling waartoe de resource behoort. U moet verzamelingsbeperking gebruiken wanneer de gebruiker geen rechten voor leesresources voor verzamelingen heeft; anders worden er geen gegevens geretourneerd. Voor SMS 2.0 met Service Pack 1 en latere versies geldt deze beperking alleen voor klassen die zijn afgeleid van SMS_Group.

U kunt deze kwalificatie niet gebruiken bij het opvragen van verzamelingen.

LocaleID

De LocaleID contextkwalificatie is een tekenreekswaarde die een hexadecimale waarde of een decimale waarde accepteert in de vorm MS\x, waarbij x de landinstellings-id is. U kunt bijvoorbeeld de Engelse LocaleID waarde invoeren als ms\0x0409 of ms\1033. De SMS-provider accepteert LocaleID alleen waarden die de Microsoft-indeling gebruiken. U vindt een lijst met locale IDslandinstellingen-id's die zijn toegewezen door Microsoft.

Als u de landinstelling nodig hebt voor niet-Amerikaanse installaties kunt u deze ophalen via de WMI-klasse-eigenschapLocaleID SMS_Identification-server.

MachineName

De MachineName contextkwalificatie is een tekenreekswaarde die aangeeft op welke computer de toepassing wordt uitgevoerd. U moet opgeven MachineName voor uw toepassing omdat deze wordt gebruikt voor controle. Als u de computernaam niet opgeeft, wordt de waarde Onbekend gebruikt. U moet de waarde MachineName opgeven wanneer u een van de methoden voor het genereren van statusberichten aanroept, zoals SMS_StatusMessage::RaiseRawStatusMsg, anders mislukt de aanroep.

QueryQualifiers

De QueryQualifiers contextkwalificatie is een Booleaanse waarde die wordt gebruikt om de SecurityVerbs-bitvlaggen te retourneren wanneer u query's uitvoert op beveiligde objecten, zoals SMS_Site of SMS_Package. Houd er rekening mee dat bij het uitvoeren QueryQualifiers van query's op niet-beveiligde objecten een fout wordt gegenereerd. SecurityVerbs-vlaggen worden standaard niet geretourneerd met de query. U moet deze kwalificatie maken en de waarde ervan instellen op true als u de vlaggen wilt retourneren. Niet maken QueryQualifiers is hetzelfde als het instellen van de waarde op false.

SessionHandle

De SessionHandle contextkwalificatie is een tekenreekswaarde die wordt geretourneerd als een out-parameter van de methode GetSessionHandle. De tekenreeks is een unieke GUID die de kopie van uw toepassing van het sitebeheerbestand naar Configuration Manager identificeert. U moet dit mechanisme gebruiken om het sitebeheerbestand te wijzigen en gegevensconflicten te verminderen met andere toepassingen die tegelijkertijd het sitebeheerbestand wijzigen. Als u geen waarde opgeeft SessionHandle , wijzigt uw toepassing de globale kopie van het sitebeheerbestand, dat geen bescherming biedt tegen toepassingen die elkaars gegevens overschrijven.