O řídicím souboru webu Configuration Manager

Článek
04/04/2023

Ovládací prvek webu v Configuration Manager definuje nastavení pro konkrétní web. Nastavení pro jednotlivé lokality jsou obsažena v databázi a při práci se spravovaným jazykem jsou přístupná prostřednictvím rozhraní WMI (Windows Management Instrumentation) a spravované knihovny poskytovatele serveru SMS při práci se spravovaným jazykem.

Poznámka

Předchozí verze Configuration Manager obsahovaly fyzický soubor, který byl zpracován pro nastavení webu označovaný jako řídicí soubor webu. Configuration Manager ukládá nastavení lokality přímo do databáze lokality. Při konfiguraci lokality prostřednictvím kódu programu se ale změnilo velmi málo.

Řídicí soubor webu v Configuration Manager je textový soubor ASCII (Sitectrl.ct0), který obsahuje konfiguraci jednotlivých lokalit. Existují dva typy řídicích souborů webu:

Skutečný řídicí soubor lokality – pracovní kopie řídicího souboru lokality, která je uložená v Configuration Manager databázi lokality a ve složce Doručená pošta ve správci řízení lokality.
Řídicí soubor rozdílového webu – obsahuje navrhované změny řídicího souboru webu, které se mají zpracovat.

Řídicí soubor lokality je uložen na každém serveru lokality v doručené poště správce řízení lokality.

V primární lokalitě je kopie řídicího souboru lokality pro aktuální lokalitu v databázi. Primární lokalita má také kopii řídicího souboru lokality pro všechny lokality nižší úrovně v hierarchii, včetně sekundárních lokalit.

Každá podřízená lokalita předává kopii svého řídicího souboru webu do nadřazené lokality. Každá nadřazená lokalita předává kopii řídicího souboru lokality pro sebe a pro každou podřízenou lokalitu v hierarchii. Databáze centrální lokality proto obsahuje kopie řídicích souborů lokality každé Configuration Manager lokality v hierarchii.

Formát souboru ovládacího prvku webu

Řídicí soubor webu je kolekce definic prostředků, které obsahují vložené vlastnosti, seznamy vložených vlastností a víceřetězcové seznamy. Následující příklad ukazuje část řídicího souboru lokality, která definuje informace o komponentě klienta. Prostředek je deklarován BEGIN_CLIENT_COMPONENT. Vložené vlastnosti jsou označené vlastností PROPERTY a mají název a hodnotu. Seznamy vlastností jsou označeny oddílem BEGIN_PROPERTY_LIST a seznam obsahuje název seznamu vlastností a několik názvů vlastností a přidružených hodnot. Víceřetězcové seznamy jsou označeny BEGIN_CLIENT_REG_MULTI_STRING_LIST a poskytují seznam řetězcových hodnot.

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

Poskytovatel má několik tříd rozhraní WMI (Windows Management Instrumentation), které představují prostředky v souboru ovládacího prvku lokality. Například serverová třída služby WMI SMS_SCI_Component uchovává informace o serverových komponentách uložených na serveru Configuration Manager lokality. Tyto třídy jsou odvozeny od SMS_SiteControlItem serverové třídy služby WMI. Další informace najdete v tématu Configuration Manager Serverové třídy služby WMI konfigurace lokality [referenční informace].

V následujícím příkladu je deklarace serverové třídy služby WMI SMS_SCI_ClientConfig.

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;  
};

Deklarace obsahuje deklarace pro vloženou vlastnost, seznam vlastností a víceřetězcové deklarace seznamu.

K vloženým vlastnostem, seznamům vlastností a víceřetězcovým seznamům můžete přistupovat pomocí následujících tříd:

Typ	Třída služby WMI
Vložená vlastnost	Serverová třída služby WMI SMS_EmbeddedProperty
Seznam vložených vlastností	Serverová třída služby WMI SMS_EmbeddedPropertyList (array)
Víceřetězcový seznam	Serverová třída služby WMI SMS_Client_Reg_MultiString_List (pole)

Tato dokumentace obsahuje následující téma, které popisuje vložené vlastnosti:

Čtení seznamu vložených vlastností souboru ovládacího prvku webu Configuration Manager

Použití ovládacího souboru webu

Způsob přístupu k řídicímu souboru webu se liší v závislosti na tom, jestli používáte rozhraní WMI nebo spravovaného poskytovatele.

Služby wmi

Pokud používáte rozhraní WMI, můžete pomocí SMS_SiteControlFile metod třídy spravovat změny v souboru ovládacího prvku webu. Zápis do řídicího souboru lokality se spravuje pomocí kontextových informací relace, které zadáte. Slouží k povolení souběžného zápisu do řídicího souboru lokality pro více aplikací. Další informace najdete v tématu Čtení a zápis do řídicího souboru Configuration Manager webu pomocí rozhraní WMI Pokud čtete jenom z řídicího souboru webu, můžete se na něj dotazovat bez nastavení relace.

Spravovaný poskytovatel

Téměř ve všech případech nemusí kód zamykat ani potvrzovat změny v řídicím souboru Configuration Manager webu, protože spravovaná knihovna Configuration Manager se o to postará za vás. V důsledku toho je programování řídicího souboru Configuration Manager lokality v podstatě stejné jako programování Configuration Manager objektů. To se liší od přístupu k řídicímu souboru Configuration Manager webu prostřednictvím rozhraní WMI, kde musíte explicitně získat popisovač relace a potvrdit všechny provedené změny.

Další informace najdete v tématu Jak číst a zapisovat do řídicího souboru Configuration Manager webu pomocí spravovaného kódu.

Viz taky

Čtení a zápis do řídicího souboru webu Configuration Manager pomocí spravovaného kódu
Čtení a zápis do řídicího souboru webu Configuration Manager pomocí rozhraní WMI

Sdílet prostřednictvím