Tudnivalók a Configuration Manager webhelyvezérlő fájlról

Cikk
04/04/2023

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

Share via