Tudnivalók a Configuration Manager webhelyvezérlő fájlról
A webhelyvezérlő Configuration Manager egy adott webhely beállításait határozza meg. Az egyes helyek beállításai az adatbázisban találhatók, és a Windows Management Instrumentation (WMI) segítségével érhetők el a parancsfájl-kezelési nyelvek használatakor, valamint a felügyelt SMS-szolgáltató könyvtárán keresztül, amikor felügyelt nyelvvel dolgozik.
Megjegyzés:
A Configuration Manager korábbi kiadásaiban volt egy fizikai fájl, amelyet a helyvezérlő fájlnak nevezett helybeállításokhoz dolgoztak fel. Configuration Manager a helybeállításokat közvetlenül a helyadatbázisban tárolja, azonban a webhely programozott konfigurálásakor nagyon kevés változás történt.
A Configuration Manager helyvezérlő fájlja egy ASCII-szövegfájl (Sitectrl.ct0), amely az egyes helyek konfigurációját tartalmazza. A webhelyvezérlő fájloknak két típusa van:
Tényleges helyvezérlő fájl – A helyvezérlő fájl működő példánya, amely a Configuration Manager helyadatbázisban és a helyvezérlő beérkezett üzenetek mappájában található.
Delta-hely vezérlőfájl – A feldolgozandó helyvezérlőfájl javasolt módosításait tartalmazza.
A helyvezérlő fájl minden helykiszolgálón a Helyvezérlő-kezelő beérkezett üzenetek mappájában található.
Az elsődleges helyen található az adatbázis aktuális helyének helyvezérlő fájljának másolata. Az elsődleges hely a helyvezérlő fájl másolatával is rendelkezik a hierarchia összes alacsonyabb szintű helyéhez, beleértve a másodlagos helyeket is.
Minden gyermekhely átadja a helyvezérlő fájl másolatát a szülőwebhelyének. Minden szülőhely átadja a helyvezérlő fájl másolatát magának és minden gyermekwebhelyének a hierarchiában. Ezért a központi hely adatbázisa a hierarchiában lévő összes Configuration Manager hely helyvezérlő fájljainak másolatait tartalmazza.
Webhelyvezérlő fájlformátuma
A webhelyvezérlő fájl beágyazott tulajdonságokat, beágyazott tulajdonságlistákat és többsztringes listákat tartalmazó erőforrás-definíciók gyűjteménye. Az alábbi példa a helyvezérlő fájl egy olyan szakaszát mutatja be, amely meghatározza az ügyfél-összetevő adatait. Az erőforrást a BEGIN_CLIENT_COMPONENT deklarálja. A beágyazott tulajdonságokat TULAJDONSÁG jelöli, és névvel és értékkel rendelkeznek. A tulajdonságlistákat a BEGIN_PROPERTY_LIST szakasz jelöli, és felsorolja a tulajdonságlista nevét, valamint számos tulajdonságnevet és kapcsolódó értéket. A többsztringes listákat a BEGIN_CLIENT_REG_MULTI_STRING_LIST jelöli, és sztringértékek listáját adja meg.
BEGIN_CLIENT_COMPONENT
<SMS Client Base Components>
<65537>
SITE_KEY_FLAGS <1>
PROPERTY <Component Verify Interval><REG_SZ><00011700001000F0><0>
PROPERTY <Component Maintenance Interval (minutes)><REG_DWORD><><1500>
BEGIN_PROPERTY_LIST
<Copy Queue>
<(REG_DWORD)Item Lifetime=11520>
<(REG_DWORD)Wakeup cycle=1380>
END_PROPERTY_LIST
BEGIN_CLIENT_REG_MULTI_STRING_LIST
<Retry Sequence><Copy Queue>
SITE_KEY_FLAGS <1>
<15>
<30>
<60>
<360>
END_CLIENT_REG_MULTI_STRING_LIST
END_CLIENT_COMPONENT
A szolgáltató számos Windows Management Instrumentation (WMI) osztálysal rendelkezik, amelyek a helyvezérlő fájl erőforrásait képviselik. Például SMS_SCI_Component kiszolgálói WMI-osztály egy Configuration Manager helykiszolgálón tárolt kiszolgáló-összetevőkre vonatkozó információkat tartalmaz. Ezek az osztályok SMS_SiteControlItem kiszolgálói WMI-osztályból származnak. További információ: Configuration Manager helykonfigurációs kiszolgálói WMI-osztályok [referencia].
Az alábbi példa SMS_SCI_ClientConfig kiszolgálói WMI-osztály deklarációja.
Class SMS_SCI_ClientConfig : SMS_SiteControlItem
{
String ClientConfigName;
UInt32 FileType;
UInt32 Flags;
String ItemName;
String ItemType;
String Platforms[];
SMS_EmbeddedPropertyList PropLists[];
SMS_EmbeddedProperty Props[];
SMS_Client_Reg_MultiString_List RegMultiStringLists[];
String SiteCode;
};
A deklaráció tartalmazza a beágyazott tulajdonság, a tulajdonságlista és a többsztringes lista deklarációit.
A beágyazott tulajdonságokat, tulajdonságlistákat és több sztringes listákat az alábbi osztályok használatával érheti el:
| Típus | WMI-osztály |
|---|---|
| Beágyazott tulajdonság | SMS_EmbeddedProperty kiszolgálói WMI-osztály |
| Beágyazott tulajdonságlista | SMS_EmbeddedPropertyList kiszolgálói WMI-osztály (tömb) |
| Többsztringes lista | SMS_Client_Reg_MultiString_List kiszolgálói WMI-osztály (tömb) |
Ez a dokumentáció a következő témakört tartalmazza, amely a beágyazott tulajdonságokat ismerteti:
Configuration Manager webhelyvezérlő fájl beágyazott tulajdonságlistájának olvasása
A webhelyvezérlő fájl használata
A helyvezérlő fájl elérésének menete attól függően változik, hogy WMI-t vagy felügyelt szolgáltatót használ.
Wmi
WMI használata esetén az SMS_SiteControlFile osztálymetórán keresztül kezelheti a helyvezérlő fájl módosításait. A webhelyvezérlő fájlba való írást a megadott munkamenet-környezetfüggő információk kezelik. Ez lehetővé teszi több alkalmazás egyidejű írását a helyvezérlő fájlba. További információ: Olvasás és írás a Configuration Manager webhelyvezérlő fájlba WMI használatával Ha csak a webhelyvezérlő fájlból olvas, munkamenet beállítása nélkül kérdezheti le.
Felügyelt szolgáltató
Szinte minden esetben a kódnak nem kell zárolnia vagy véglegesítenie a módosításokat a Configuration Manager webhelyvezérlő fájlban, mert a felügyelt Configuration Manager tár gondoskodik erről. Ennek eredményeképpen a Configuration Manager helyvezérlő fájl programozása alapvetően ugyanaz, mint Configuration Manager objektumok programozása. Ez eltér a Configuration Manager helyvezérlő fájl WMI-ben való elérésétől, ahol explicit módon le kell szereznie egy munkamenet-leírót, és véglegesítenie kell a módosításokat.
További információ: Az Configuration Manager webhelyvezérlő fájl olvasása és írása felügyelt kód használatával.
Lásd még
A Configuration Manager helyvezérlő fájl olvasása és írása felügyelt kód használatával
A Configuration Manager helyvezérlő fájl olvasása és írása WMI használatával