Om Configuration Manager-platskontrollfilen

Platskontroll i Configuration Manager definierar inställningarna för en viss webbplats. Inställningarna för varje plats finns i databasen och nås via Windows Management Instrumentation (WMI) när du arbetar med skriptspråk och via det hanterade SMS-providerbiblioteket när du arbetar med ett hanterat språk.

Obs!

Tidigare versioner av Configuration Manager hade en fysisk fil som bearbetades för platsinställningar som kallas platskontrollfilen. Configuration Manager lagrar platsinställningar direkt i platsdatabasen, men mycket lite har ändrats när du programmatiskt konfigurerar en plats.

Platskontrollfilen i Configuration Manager är en ASCII-textfil (Sitectrl.ct0) som innehåller konfigurationen för varje plats. Det finns två typer av platskontrollfiler:

• Faktisk platskontrollfil – En fungerande kopia av platskontrollfilen som lagras i Configuration Manager platsdatabasen och i inkorgen i platskontrollhanteraren.

• Deltaplatskontrollfil – Innehåller de föreslagna ändringar av platskontrollfilen som ska bearbetas.

  Platskontrollfilen lagras på varje platsserver i inkorgen för platskontrollhanteraren.

  På den primära platsen finns det en kopia av platskontrollfilen för den aktuella platsen i databasen. Den primära platsen har också en kopia av platskontrollfilen för alla lägre platser i hierarkin, inklusive sekundära platser.

  Varje underordnad plats skickar en kopia av platskontrollfilen till den överordnade platsen. Varje överordnad plats skickar en kopia av platskontrollfilen för sig själv och för var och en av dess underordnade platser uppåt i hierarkin. Därför innehåller den centrala platsens databas kopior av platskontrollfilerna för varje Configuration Manager plats i hierarkin.

Filformat för platskontroll

Platskontrollfilen är en samling resursdefinitioner som innehåller inbäddade egenskaper, inbäddade egenskapslistor och listor med flera strängar. I följande exempel visas ett avsnitt av platskontrollfilen som definierar klientkomponentinformation. Resursen deklareras av BEGIN_CLIENT_COMPONENT. De inbäddade egenskaperna anges av EGENSKAPEN och har ett namn och värde. Egenskapslistorna anges av avsnittet BEGIN_PROPERTY_LIST och listar ett namn på egenskapslistan och flera egenskapsnamn och associerade värden. Listorna med flera strängar anges av BEGIN_CLIENT_REG_MULTI_STRING_LIST och innehåller en lista med strängvärden.

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  

Providern har flera WMI-klasser (Windows Management Instrumentation) som representerar resurser i platskontrollfilen. Till exempel innehåller SMS_SCI_Component serverns WMI-klass information om de serverkomponenter som lagras på en Configuration Manager platsserver. Dessa klasser härleds från SMS_SiteControlItem serverns WMI-klass. Mer information finns i Configuration Manager WMI-klasser för platskonfigurationsserver [referens].

Följande exempel är deklarationen för SMS_SCI_ClientConfig serverns WMI-klass.

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

Deklarationen innehåller deklarationer för den inbäddade egenskapen, egenskapslistan och listdeklarationer med flera strängar.

Du kommer åt de inbäddade egenskaperna, egenskapslistorna och flersträngslistorna med hjälp av följande klasser:

Typ	WMI-klass
Inbäddad egenskap	SMS_EmbeddedProperty, serverns WMI-klass
Inbäddad egenskapslista	SMS_EmbeddedPropertyList serverns WMI-klass (matris)
Lista med flera strängar	SMS_Client_Reg_MultiString_List serverns WMI-klass (matris)

Den här dokumentationen innehåller följande avsnitt som beskriver de inbäddade egenskaperna:

Så här läser du en Configuration Manager webbplatskontrollfil inbäddad egenskapslista

Använda platskontrollfilen

Hur du kommer åt platskontrollfilen varierar beroende på om du använder WMI eller den hanterade providern.

WMI

När du använder WMI använder du klassmetoderna SMS_SiteControlFile för att hantera ändringar i platskontrollfilen. Skrivning till platskontrollfilen hanteras med hjälp av sammanhangsbaserad information för sessioner som du anger. Detta används för att aktivera samtidig skrivning till platskontrollfilen för flera program. Mer information finns i Läsa och skriva till Configuration Manager platskontrollfil med hjälp av WMI Om du bara läser från platskontrollfilen kan du fråga den utan att konfigurera en session.

Hanterad provider

I nästan alla fall behöver koden inte låsa eller checka in ändringar i Configuration Manager platskontrollfil eftersom det hanterade Configuration Manager-biblioteket tar hand om detta åt dig. Därför är programmering av Configuration Manager platskontrollfil i grunden detsamma som programmering Configuration Manager objekt. Detta skiljer sig från att komma åt Configuration Manager platskontrollfil via WMI där du uttryckligen måste hämta en sessionsreferens och checka in alla ändringar du gör.

Mer information finns i Läsa och skriva till Configuration Manager platskontrollfil med hjälp av hanterad kod.

Se även

Läsa och skriva till Configuration Manager platskontrollfil med hjälp av hanterad kod
Läsa och skriva till Configuration Manager platskontrollfil med hjälp av WMI