Kvalifikátory kontextu Configuration Manageru

Článek
07/04/2024

Kontextové objekty se v nástroji Configuration Manager používají k poskytování dalších informací poskytovateli serveru SMS. Kontextové kvalifikátory se obvykle používají k poskytnutí kontextových informací o poskytovateli serveru SMS, jako je například název vaší aplikace. Kontextové kvalifikátory můžete použít při připojování k poskytovateli serveru SMS a k jednotlivým objektům poskytovatele serveru SMS.

Spravovaný kód

Při použití spravovaných knihoven poskytovatele serveru SMS použijete vlastnost ConnectionManagerBase.Context k určení kontextových kvalifikátorů. Další informace najdete v tématu Přidání kvalifikátoru kontextu Configuration Manageru pomocí spravovaného kódu.

VBScript

Při použití jazyka VBScript použijete sadu rozhraní SWBemNamedValue k určení kontextových kvalifikátorů jako kolekce pojmenovaných objektů hodnot. Další informace najdete v tématu Přidání kvalifikátoru kontextu nástroje Configuration Manager pomocí rozhraní WMI.

Kontextové kvalifikátory

Následující tabulka obsahuje kontextové kvalifikátory (pojmenované hodnoty), které používá poskytovatel serveru SMS. Většina kvalifikátorů, jako SessionHandleje , se používá pouze s konkrétními funkčními oblastmi poskytovatele serveru SMS, ale LocaleID, MachineNamea ApplicationName jsou určené pro použití vaší aplikace.

Kontextový kvalifikátor	Popis
`ApplicationName`	Identifikuje aplikaci, která provedla volání.
`ContextHandle`	Určuje, kam poskytovatel serveru SMS uložil kontextové kvalifikátory uložené v mezipaměti.
`InstanceCount`	Omezuje počet instancí vrácených z ExecQuery a CreateInstanceEnum.
`LimitToCollectionIDs`	Omezuje výsledky dotazu na prostředky na členy pojmenovaných kolekcí.
`LocaleID`	Identifikuje znakovou stránku, která se má použít.
`MachineName`	Určuje, na kterém počítači je spuštěna aplikace.
`QueryQualifiers`	Vrátí příznaky SecurityVerbs bit při provádění dotazů na zabezpečené objekty.
`SessionHandle`	Identifikuje kopii řídicího souboru lokality vaší aplikace do nástroje Configuration Manager.

Název_aplikace

Kontextový ApplicationName kvalifikátor je řetězcová hodnota, která identifikuje název aplikace, která provedla volání. Pro aplikaci byste měli zadat ApplicationName , protože se používá k auditování. Pokud nezadáte název aplikace, použije se hodnota Neznámý. Při volání jakékoli metody vyvolání stavové zprávy, například SMS_StatusMessage::RaiseErrorStatusMsg, musíte zadat ApplicationName hodnotu, jinak volání selže.

ContextHandle

Kontextový ContextHandle kvalifikátor je řetězcová hodnota, která určuje, kam poskytovatel serveru SMS uložil kontextové kvalifikátory uložené v mezipaměti. Přenos dat spravuje spravovaný poskytovatel serveru SMS. Při použití jazyka VBScript můžete pomocí následujících kroků snížit množství dat předávaných přes síť.

Vytvořte sadu hodnot SWBemNamedValue .
Přidejte kvalifikátory do objektu kontextu. Další informace najdete v tématu Přidání kvalifikátoru kontextu nástroje Configuration Manager pomocí rozhraní WMI.
Volejte metodu GetContextHandle pro ukládání kvalifikátorů do mezipaměti na serveru. Poskytovatel serveru SMS ukládá kontextový objekt, který předáte jako parametr ExecMethod při volání GetContextHandle.
Odeberte všechny kvalifikátory z objektu kontextu.
Přidejte kvalifikátor ContextHandle a hodnotu do objektu kontextu.
Předejte kontextový objekt pro všechna volání služby IWbemServices.

Před ukončením aplikace musíte volat metodu ClearContextHandle k odebrání kvalifikátorů uložených v mezipaměti. Můžete vytvořit libovolný počet ContextHandle hodnot, přičemž každá z nich poskytuje pro vaši aplikaci různé informace.

Poznámka

Po uložení kontextových kvalifikátorů do mezipaměti můžete hodnoty uložené v mezipaměti přepsat přidáním stejných kontextových kvalifikátorů s různými hodnotami do objektu kontextu.

InstanceCount

Kontextový InstanceCount kvalifikátor je celočíselná hodnota, která se používá k omezení počtu instancí vrácených z metod ExecQuery a CreateInstanceEnum . Nastavíte InstanceCount , aby se rovnal maximálnímu počtu instancí, které chcete vrátit z dotazu nebo enumerátoru. Například nastavení InstanceCount na 10 vrátí maximálně 10 instancí.

LimitToCollectionIDs

Kontextový LimitToCollectionIDs kvalifikátor je pole řetězců, které obsahuje seznam CollectionID hodnot. V současné době můžete zadat pouze jednu CollectionID hodnotu. Tento kvalifikátor slouží k omezení výsledků dotazu na prostředky na členy pojmenované kolekce. Dotaz na prostředky je dotaz, který obsahuje třídy odvozené z SMS_Resource nebo SMS_Group.

Uživatel musí mít oprávnění ke čtení prostředku instance pro kolekci, do které prostředek patří. Pokud uživatel nemá oprávnění ke čtení prostředků třídy pro kolekce, musíte použít omezení kolekce. jinak se nevrátí žádná data. Pro server SMS 2.0 s aktualizací Service Pack 1 a novější verze se toto omezení vztahuje pouze na třídy odvozené z SMS_Group.

Tento kvalifikátor nelze použít při dotazování kolekcí.

ID národního prostředí

Kontextový LocaleID kvalifikátor je řetězcová hodnota, která přijímá buď šestnáctkovou hodnotu, nebo desetinnou hodnotu ve formátu MS\x, kde x je ID národního prostředí. Můžete například zadat anglickou LocaleID hodnotu ms\0x0409 nebo ms\1033. Poskytovatel serveru SMS přijímá LocaleID pouze hodnoty, které používají formát Microsoftu. Seznam locale IDs najdete v tématu ID národního prostředí přiřazených Microsoftem.

Pokud potřebujete národní prostředí pro jiné uživatele než USA můžete ho získat z vlastnosti SMS_Identification serverová třídaLocaleID služby WMI.

Název počítače

Kontextový MachineName kvalifikátor je řetězcová hodnota, která identifikuje, na kterém počítači aplikaci běží. Pro aplikaci byste měli zadat MachineName , protože se používá k auditování. Pokud nezadáte název počítače, použije se hodnota Neznámý. Při volání jakékoli metody vyvolání stavové zprávy, například SMS_StatusMessage::RaiseRawStatusMsg, musíte zadat hodnotu MachineName, jinak volání selže.

QueryQualifiers

Kontextový QueryQualifiers kvalifikátor je logická hodnota, která se používá k vrácení bitových příznaků SecurityVerbs při spouštění dotazů na zabezpečené objekty, jako jsou SMS_Site nebo SMS_Package. Všimněte si, že použití při QueryQualifiers dotazování nezabezpečených objektů generuje chybu. Ve výchozím nastavení se příznaky SecurityVerbs nevrací s dotazem. Pokud chcete vrátit příznaky, musíte tento kvalifikátor vytvořit a nastavit jeho hodnotu na true . Nevytvářet QueryQualifiers je totéž jako nastavení jeho hodnoty na false.

SessionHandle

Kontextový SessionHandle kvalifikátor je řetězcová hodnota, která se vrátí jako out parametr metody GetSessionHandle. Řetězec je jedinečný identifikátor GUID, který identifikuje kopii řídicího souboru lokality vaší aplikace do nástroje Configuration Manager. Tento mechanismus byste měli použít k úpravě řídicího souboru lokality a omezení kolizí dat s jinými aplikacemi, které současně upravují řídicí soubor lokality. Pokud nezadáte SessionHandle hodnotu, aplikace upraví globální kopii řídicího souboru lokality, která nemá žádnou ochranu před tím, než aplikace vzájemně přepisují data.