A Configuration Manager környezeti minősítői

Cikk
04/04/2023

A Configuration Managerben a környezeti objektumok további információk megadására szolgálnak az SMS-szolgáltató számára. Az SMS-szolgáltató környezetfüggő információkat, például az alkalmazás nevét általában környezeti minősítők használatával adja meg. A környezetjelölőket akkor használhatja, ha az SMS-szolgáltatóhoz és az egyes SMS Provider-objektumokhoz csatlakozik.

Felügyelt kód

A felügyelt SMS-szolgáltatói kódtárak használatakor a ConnectionManagerBase.Context tulajdonság használatával adja meg a környezeti minősítőket. További információ: Configuration Manager környezeti minősítő hozzáadása felügyelt kód használatával.

VBScript

VBScript használata esetén a SWBemNamedValue felületkészlettel a környezeti minősítőket névvel ellátott értékobjektumok gyűjteményeként adhatja meg. További információ: Configuration Manager környezeti minősítő hozzáadása WMI használatával.

Környezeti minősítők

Az alábbi táblázat az SMS-szolgáltató által használt környezeti minősítőket (névvel ellátott értékeket) tartalmazza. A legtöbb minősítő ( például SessionHandle) csak az SMS-szolgáltató meghatározott funkcionális területeihez használatos, de LocaleIDa , MachineNameés ApplicationName az alkalmazáshoz is használható.

Környezeti minősítő	Leírás
`ApplicationName`	Azonosítja a hívást kezdeményező alkalmazást.
`ContextHandle`	Azonosítja, hogy az SMS-szolgáltató hol tárolta a gyorsítótárazott környezet minősítőit.
`InstanceCount`	Korlátozza az ExecQuery és a CreateInstanceEnum által visszaadott példányok számát.
`LimitToCollectionIDs`	Az erőforrás-lekérdezések eredményeit a nevesített gyűjtemények tagjaira korlátozza.
`LocaleID`	Azonosítja a használni kívánt kódlapot.
`MachineName`	Azonosítja, hogy melyik számítógép futtatja az alkalmazást.
`QueryQualifiers`	Visszaadja a SecurityVerbs bitjelölőit, amikor biztonságos objektumokon hajt végre lekérdezéseket.
`SessionHandle`	Azonosítja, hogy az alkalmazás másolatot készít-e a helyvezérlő fájlról a Configuration Managerben.

ApplicationName

A ApplicationName környezeti minősítő egy sztringérték, amely azonosítja a hívást kezdeményező alkalmazás nevét. Meg kell adnia ApplicationName az alkalmazást, mert naplózáshoz használják. Ha nem adja meg az alkalmazás nevét, a rendszer az Ismeretlen értéket használja. Meg kell adnia az ApplicationName értéket, amikor meghívja az emelési állapotüzenet metódusait, például SMS_StatusMessage::RaiseErrorStatusMsg, különben a hívás sikertelen lesz.

ContextHandle

A ContextHandle környezeti minősítő egy sztringérték, amely azonosítja, hogy az SMS-szolgáltató hol tárolta a gyorsítótárazott környezeti minősítőket. A felügyelt SMS-szolgáltató kezeli az adatátvitelt. A VBScript használata esetén az alábbi lépésekkel csökkentheti a hálózaton áthaladó adatok mennyiségét.

HOZZON LÉTRE SWBemNamedValue értékkészletet.
Adja hozzá a minősítőket a környezeti objektumhoz. További információ: Configuration Manager környezeti minősítő hozzáadása WMI használatával.
Hívja meg a GetContextHandle metódust a minősítők gyorsítótárazásához a kiszolgálón. Az SMS-szolgáltató gyorsítótárazza azt a környezeti objektumot, amelyet a GetContextHandle meghívásakor az ExecMethod paramétereként ad át.
Távolítsa el az összes minősítőt a környezeti objektumból.
Adja hozzá a ContextHandle minősítőt és az értéket a környezeti objektumhoz.
Adja át a környezeti objektumot minden híváson az IWbemServices szolgáltatásnak.

Az alkalmazásból való kilépés előtt meg kell hívnia a ClearContextHandle metódust a gyorsítótárazott minősítők eltávolításához. Tetszőleges számú ContextHandle értéket hozhat létre, amelyek mindegyike különböző információkat biztosít az alkalmazás számára.

Megjegyzés:

A környezeti minősítők gyorsítótárazása után felülbírálhatja a gyorsítótárazott értékeket, ha ugyanazokat a környezeti minősítőket adja hozzá különböző értékekkel a környezeti objektumhoz.

InstanceCount

A InstanceCount környezeti minősítő egy egész szám, amely az ExecQuery és a CreateInstanceEnum metódusból visszaadott példányok számának korlátozására szolgál. A lekérdezésből vagy enumerátorból visszaadni kívánt példányok maximális számát kell megadnia InstanceCount . A 10 értékre állítás InstanceCount például legfeljebb 10 példányt ad vissza.

LimitToCollectionIDs

A LimitToCollectionIDs környezeti minősítő egy értéklistát CollectionID tartalmazó sztringtömb. Jelenleg csak egy CollectionID értéket adhat meg. Ezzel a minősítővel korlátozhatja az erőforrás-lekérdezések eredményeit a nevesített gyűjtemény tagjaira. Az erőforrás-lekérdezések olyan lekérdezések, amelyek SMS_Resource vagy SMS_Group származtatott osztályokat tartalmaznak.

A felhasználónak példányolvasási erőforrás-engedélyekkel kell rendelkeznie ahhoz a gyűjteményhez, amelyhez az erőforrás tartozik. Gyűjteménykorlátozást kell alkalmaznia, ha a felhasználó nem rendelkezik osztályolvasási erőforrás-jogosultságokkal a gyűjteményekhez; ellenkező esetben a függvény nem ad vissza adatokat. A Service Pack 1-et és újabb verziókat tartalmazó SMS 2.0 esetében ez a korlátozás csak a SMS_Group származó osztályokra vonatkozik.

Gyűjtemények lekérdezéséhez nem használhatja ezt a minősítőt.

Területi azonosító

A LocaleID környezeti minősítő egy sztringérték, amely hexadecimális értéket vagy decimális értéket fogad el MS\x formában, ahol x a területi azonosító. Megadhatja például az angol LocaleID értéket ms\0x0409 vagy ms\1033 néven. Az SMS-szolgáltató csak a Microsoft formátumot használó értékeket fogadja el LocaleID . A listáját locale IDs a Microsoft által hozzárendelt területi azonosítók között találja.

Ha nem egyesült államokbeli területi beállításra van szüksége telepítéseket, a SMS_Identification kiszolgálói WMI-osztályLocaleID tulajdonságból szerezheti be.

MachineName

A MachineName környezeti minősítő egy sztringérték, amely azonosítja, hogy melyik számítógép futtatja az alkalmazást. Meg kell adnia MachineName az alkalmazást, mert naplózáshoz használják. Ha nem adja meg a számítógép nevét, a rendszer az Ismeretlen értéket használja. A MachineName értéket akkor kell megadnia, amikor meghívja az állapotfelemelési üzenet metódusait, például SMS_StatusMessage::RaiseRawStatusMsg, különben a hívás sikertelen lesz.

QueryQualifiers

A QueryQualifiers környezeti minősítő egy logikai érték, amely a SecurityVerbs bitjelölőinek visszaadására szolgál, amikor lekérdezéseket hajt végre biztonságos objektumokon, például SMS_Site vagy SMS_Package. Vegye figyelembe, hogy a nem biztonságos objektumok lekérdezésekor a használata QueryQualifiers hibát eredményez. Alapértelmezés szerint a Rendszer nem ad vissza SecurityVerbs-jelzőket a lekérdezéssel. Ezt a minősítőt létre kell hoznia, és az értékét értékre true kell állítania, ha vissza szeretné adni a jelzőket. A létrehozás QueryQualifiers nem ugyanaz, mint az értékének beállítása.false

SessionHandle

A SessionHandle környezeti minősítő egy sztringérték, amelyet a Rendszer a GetSessionHandle metódus out paramétereként ad vissza. A sztring egy egyedi GUID, amely azonosítja az alkalmazás helyvezérlő fájljának a Configuration Managerbe történő másolatát. Ezzel a mechanizmussal módosíthatja a helyvezérlő fájlt, és csökkentheti az adatütközést más alkalmazásokkal, amelyek egyszerre módosítják a helyvezérlő fájlt. Ha nem ad meg SessionHandle értéket, az alkalmazás módosítja a helyvezérlő fájl globális példányát, amely nem nyújt védelmet az egymás adatait felülíró alkalmazások számára.