Contextkwalificaties van Configuration Manager

Contextobjecten worden in Configuration Manager gebruikt om aanvullende informatie te verstrekken aan de SMS-provider. Meestal gebruikt u contextafhankelijke scheidingstekens om de sms-aanbieder 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 Een contextkwalificatie voor Configuration Manager toevoegen met behulp van beheerde code voor meer informatie.

VBScript

Wanneer u VBScript gebruikt, gebruikt u de interfaceset SWBemNamedValue om contextkwalificaties op te geven als een verzameling benoemde waardeobjecten. Zie Een contextkwalificatie voor Configuration Manager toevoegen met WMI voor meer informatie.

Contextkwalificaties

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

Toepassingsnaam

De ApplicationName contextkwalificatie is een tekenreekswaarde die de naam aangeeft van de toepassing die de aanroep heeft geïnitieerd. U moet voor uw toepassing opgeven ApplicationName 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 verhogen 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 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 beperken die via het netwerk worden doorgegeven.

1. Maak de SWBemNamedValue-waardeset .

2. Voeg de kwalificaties toe aan het contextobject. Zie Een contextkwalificatie voor Configuration Manager toevoegen met WMI voor meer informatie.

3. Roep de methode GetContextHandle aan om de kwalificaties op te slaan in de cachecache op de server. De sms-provider slaat het contextobject dat u doorgeeft als parameter van ExecMethod op in de cache wanneer u GetContextHandle aanroept.

4. Verwijder alle scheidingstekens uit het contextobject.

5. Voeg het scheidingsteken en de ContextHandle waarde toe aan het contextobject.

6. Geef het contextobject bij alle oproepen door aan IWbemServices.

   U moet de methode ClearContextHandle aanroepen om de kwalificaties in de cache te verwijderen voordat u de toepassing afsluit. U kunt zoveel ContextHandle waarden maken als u wilt, waarbij elke waarde een andere informatie voor uw toepassing biedt.

InstanceCount

De InstanceCount contextkwalificatie is een geheel getal dat wordt gebruikt om het aantal exemplaren te beperken dat wordt geretourneerd door de ExecQuery - en CreateInstanceEnum-methoden . U stelt het InstanceCount maximum aantal exemplaren in dat u van de query of enumerator wilt retourneren. Als u bijvoorbeeld de waarde 10 opgeeft InstanceCount , krijgt dit ten hoogste 10 keer als resultaat.

LimitToCollectionID's

De LimitToCollectionIDs contextkwalificatie is een tekenreeksmatrix die een lijst met CollectionID waarden bevat. Momenteel kunt u slechts één CollectionID waarde opgeven. U gebruikt dit kwalificatiecriterium 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 bijvoorbeeld leesresourcemachtigingen hebben voor de verzameling waartoe de resource behoort. U moet verzamelingsbeperkingen toepassen wanneer de gebruiker geen klasse-leesbronrechten heeft voor verzamelingen; Anders worden er geen gegevens geretourneerd. Voor SMS 2.0 met Service Pack 1 en latere versies is deze beperking alleen van toepassing op klassen die zijn afgeleid van SMS_Group.

U kunt deze kwalificatie niet gebruiken bij het uitvoeren van query's op verzamelingen.

LocaleID

De LocaleID contextscheidingstekens zijn tekenreekswaarden die ofwel een hexadecimale waarde ofwel een decimale waarde in de notatie MS\x accepteren, waarbij x de landinstelling-id is. U kunt de Engelse LocaleID waarde bijvoorbeeld invoeren als ms\0x0409 of ms\1033. De sms-aanbieder accepteert LocaleID alleen waarden die gebruikmaken van de Microsoft-indeling. U vindt hier een lijst met locale IDslandinstelling-id's die zijn toegewezen door Microsoft.

Als u de landinstelling voor niet-Amerikaanse installaties, kunt u deze ophalen uit de eigenschap SMS_Identification Server WMI ClassLocaleID .

Machinenaam

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

QueryKwalificaties

De QueryQualifiers contextkwalificatie is een Booleaanse waarde die wordt gebruikt om de bitvlaggen SecurityVerbs 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 onbeveiligde objecten een fout wordt gegenereerd. Standaard worden SecurityVerbs-vlaggen niet geretourneerd met de query. U moet deze kwalificatie maken en de waarde ervan instellen op true als u wilt dat de vlaggen worden geretourneerd. Niet maken QueryQualifiers is hetzelfde als de waarde instellen 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 waarmee de kopie van uw toepassing van het sitebeheerbestand aan Configuration Manager wordt gekoppeld. U moet dit mechanisme gebruiken om het sitebesturingsbestand te wijzigen en gegevensconflicten met andere toepassingen die tegelijkertijd het sitebesturingsbestand wijzigen, te beperken. Als u geen SessionHandle waarde opgeeft, wijzigt uw toepassing de globale kopie van het sitebesturingsbestand, dat niet is beveiligd tegen het overschrijven van elkaars gegevens.

Zie ook

Een contextkwalificatie voor Configuration Manager toevoegen met behulp van beheerde codeEen contextkwalificatie voor Configuration Manager toevoegen met WMISMS-basisprincipes