Over het Configuration Manager sitebeheerbestand

Sitebeheer in Configuration Manager definieert de instellingen voor een specifieke site. De instellingen voor elke site bevinden zich in de database en zijn toegankelijk via Windows Management Instrumentation (WMI) wanneer u werkt met scripttalen en via de beheerde SMS-providerbibliotheek wanneer u met een beheerde taal werkt.

Opmerking

Eerdere versies van Configuration Manager een fysiek bestand hadden dat is verwerkt voor site-instellingen die het sitebeheerbestand worden genoemd. Configuration Manager slaat site-instellingen rechtstreeks op in de sitedatabase. Er is echter weinig gewijzigd wanneer een site programmatisch wordt geconfigureerd.

Het sitebeheerbestand in Configuration Manager is een ASCII-tekstbestand (Sitectrl.ct0) dat de configuratie van elke site bevat. Er zijn twee typen sitebeheerbestanden:

• Werkelijke sitebeheerbestand: een werkende kopie van het sitebeheerbestand dat is opgeslagen in de Configuration Manager sitedatabase en in het Postvak IN in sitebeheer.

• Delta-sitebeheerbestand: bevat de voorgestelde wijzigingen in het sitebeheerbestand die moeten worden verwerkt.

  Het sitebeheerbestand wordt opgeslagen op elke siteserver in het Postvak IN van sitebeheer.

  Op de primaire site bevindt zich een kopie van het sitebeheerbestand voor de huidige site in de database. De primaire site heeft ook een kopie van het sitebeheerbestand voor alle sites op een lager niveau in de hiërarchie, inclusief secundaire sites.

  Elke onderliggende site geeft een kopie van het sitebeheerbestand door aan de bovenliggende site. Elke bovenliggende site geeft een kopie van het sitebeheerbestand door voor zichzelf en voor elk van de onderliggende sites in de hiërarchie. Daarom bevat de database van de centrale site kopieën van de sitebeheerbestanden van elke Configuration Manager site in de hiërarchie.

Bestandsindeling van sitebeheer

Het sitebeheerbestand is een verzameling resourcedefinities die ingesloten eigenschappen, ingesloten eigenschappenlijsten en lijsten met meerdere tekenreeksen bevatten. In het volgende voorbeeld ziet u een sectie van het sitebeheerbestand waarin informatie over clientonderdelen wordt gedefinieerd. De resource wordt gedeclareerd door de BEGIN_CLIENT_COMPONENT. De ingesloten eigenschappen worden aangeduid met EIGENSCHAP en hebben een naam en waarde. De eigenschappenlijsten worden aangegeven door de sectie BEGIN_PROPERTY_LIST en bevatten een lijstnaam van een eigenschappenlijst en verschillende eigenschapsnamen en bijbehorende waarden. De lijsten met meerdere tekenreeksen worden aangeduid met de BEGIN_CLIENT_REG_MULTI_STRING_LIST en bieden een lijst met tekenreekswaarden.

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  

De provider heeft verschillende WMI-klassen (Windows Management Instrumentation) die resources in het sitebeheerbestand vertegenwoordigen. De WMI-klasse SMS_SCI_Component-server bevat bijvoorbeeld informatie over de serveronderdelen die zijn opgeslagen op een Configuration Manager-siteserver. Deze klassen zijn afgeleid van WMI-klasse SMS_SiteControlItem-server. Zie WMI-klassen van Configuration Manager siteconfiguratieserver [referentie] voor meer informatie.

Het volgende voorbeeld is de declaratie voor WMI-klasse SMS_SCI_ClientConfig-server.

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

De declaratie bevat declaraties voor de ingesloten eigenschap, eigenschappenlijst en lijst met meerdere tekenreeksen.

U opent de ingesloten eigenschappen, eigenschappenlijsten en lijsten met meerdere tekenreeksen met behulp van de volgende klassen:

Type	WMI-klasse
Ingesloten eigenschap	WMI-klasse SMS_EmbeddedProperty-server
Lijst met ingesloten eigenschappen	WMI-klasse SMS_EmbeddedPropertyList-server (matrix)
Lijst met meerdere tekenreeksen	WMI-klasse SMS_Client_Reg_MultiString_List-server (matrix)

Deze documentatie bevat het volgende onderwerp waarin de ingesloten eigenschappen worden beschreven:

Een lijst met ingesloten eigenschappen van Configuration Manager sitebeheerbestand lezen

Het sitebeheerbestand gebruiken

Hoe u toegang krijgt tot het sitebeheerbestand, is afhankelijk van of u WMI of de beheerde provider gebruikt.

WMI

Wanneer u WMI gebruikt, gebruikt u de SMS_SiteControlFile klassemethoden om wijzigingen in het sitebeheerbestand te beheren. Schrijven naar het sitebeheerbestand wordt beheerd met behulp van sessiecontextuele informatie die u opgeeft. Dit wordt gebruikt om gelijktijdig schrijven naar het sitebeheerbestand voor meerdere toepassingen mogelijk te maken. Zie How to Read and Write to the Configuration Manager Site Control File by Using WMI (Lezen en schrijven naar het sitebeheerbestand met WMI) Als u alleen leest uit het sitebeheerbestand, kunt u een query uitvoeren zonder een sessie in te stellen.

Beheerde provider

In bijna alle gevallen hoeft uw code niet te vergrendelen of wijzigingen door te voeren in het Configuration Manager sitebeheerbestand, omdat de beheerde Configuration Manager-bibliotheek dit voor u doet. Als gevolg hiervan is het programmeren van het Configuration Manager sitebeheerbestand in wezen hetzelfde als het programmeren van Configuration Manager-objecten. Dit verschilt van het openen van het Configuration Manager sitebeheerbestand via WMI, waarbij u expliciet een sessie-ingang moet ophalen en eventuele wijzigingen moet doorvoeren die u aanbrengt.

Zie How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Lezen en schrijven naar het Configuration Manager sitebeheerbestand met behulp van beheerde code) voor meer informatie.

Zie ook

Het Configuration Manager sitebeheerbestand lezen en schrijven met behulp van beheerde code
Lezen en schrijven naar het Configuration Manager sitebeheerbestand met behulp van WMI