Informationen zur Configuration Manager-Websitesteuerungsdatei

Die Websitesteuerung in Configuration Manager definiert die Einstellungen für eine bestimmte Website. Die Einstellungen für jeden Standort sind in der Datenbank enthalten und werden über die Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) beim Arbeiten mit Skriptsprachen und bei der Arbeit mit einer verwalteten Sprache über die Verwaltete SMS-Anbieterbibliothek aufgerufen.

Hinweis

Frühere Versionen von Configuration Manager verfügten über eine physische Datei, die für Websiteeinstellungen verarbeitet wurde, die als Standortsteuerungsdatei bezeichnet werden. Configuration Manager speichert Standorteinstellungen direkt in der Standortdatenbank. Beim programmgesteuerten Konfigurieren eines Standorts hat sich jedoch nur wenig geändert.

Die Websitesteuerungsdatei in Configuration Manager ist eine ASCII-Textdatei (Sitectrl.ct0), die die Konfiguration der einzelnen Websites enthält. Es gibt zwei Arten von Websitesteuerungsdateien:

• Tatsächliche Websitesteuerungsdatei: Eine Arbeitskopie der Standortsteuerungsdatei, die in der Configuration Manager Standortdatenbank und im Posteingang im Standortsteuerungs-Manager gespeichert ist.

• Delta-Websitesteuerungsdatei: Enthält die vorgeschlagenen Änderungen an der Websitesteuerungsdatei, die verarbeitet werden sollen.

  Die Standortsteuerungsdatei wird auf jedem Standortserver im Posteingang des Standortsteuerungs-Managers gespeichert.

  Am primären Standort befindet sich eine Kopie der Standortsteuerungsdatei für den aktuellen Standort in der Datenbank. Der primäre Standort verfügt auch über eine Kopie der Standortsteuerungsdatei für alle Standorte auf niedrigerer Ebene in der Hierarchie, einschließlich sekundärer Standorte.

  Jede untergeordnete Website übergibt eine Kopie der Websitesteuerungsdatei an die übergeordnete Website. Jeder übergeordnete Standort übergibt eine Kopie der Standortsteuerungsdatei für sich selbst und für jeden seiner untergeordneten Standorte nach oben in der Hierarchie. Daher enthält die Datenbank des zentralen Standorts Kopien der Standortsteuerungsdateien jedes Configuration Manager Standorts in der Hierarchie.

Websitesteuerelementdateiformat

Die Websitesteuerungsdatei ist eine Sammlung von Ressourcendefinitionen, die eingebettete Eigenschaften, eingebettete Eigenschaftenlisten und Listen mit mehreren Zeichenfolgen enthalten. Das folgende Beispiel zeigt einen Abschnitt der Standortsteuerungsdatei, in dem Clientkomponenteninformationen definiert werden. Die Ressource wird vom BEGIN_CLIENT_COMPONENT deklariert. Die eingebetteten Eigenschaften werden durch PROPERTY gekennzeichnet und weisen einen Namen und einen Wert auf. Die Eigenschaftenlisten werden durch den abschnitt BEGIN_PROPERTY_LIST gekennzeichnet und listen einen Eigenschaftenlistennamen sowie mehrere Eigenschaftennamen und zugeordnete Werte auf. Die Listen mit mehreren Zeichenfolgen werden durch die BEGIN_CLIENT_REG_MULTI_STRING_LIST gekennzeichnet und stellen eine Liste von Zeichenfolgenwerten bereit.

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  

Der Anbieter verfügt über mehrere WMI-Klassen (Windows Management Instrumentation), die Ressourcen in der Standortsteuerungsdatei darstellen. Beispielsweise enthält SMS_SCI_Component-Server-WMI-Klasse Informationen zu den Serverkomponenten, die auf einem Configuration Manager-Standortserver gespeichert sind. Diese Klassen werden von SMS_SiteControlItem Server-WMI-Klasse abgeleitet. Weitere Informationen finden Sie unter Configuration Manager Standortkonfigurationsserver-WMI-Klassen [Referenz].

Das folgende Beispiel ist die Deklaration für SMS_SCI_ClientConfig Server WMI-Klasse.

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

Die Deklaration enthält Deklarationen für die Deklarationen eingebetteter Eigenschaften, Eigenschaftenliste und Listen mit mehreren Zeichenfolgen.

Sie greifen mithilfe der folgenden Klassen auf die eingebetteten Eigenschaften, Eigenschaftenlisten und Listen mit mehreren Zeichenfolgen zu:

Typ	WMI-Klasse
Eingebettete Eigenschaft	WMI-Klasse des SMS_EmbeddedProperty-Servers
Eingebettete Eigenschaftenliste	SMS_EmbeddedPropertyList Server WMI-Klasse (Array)
Liste mit mehreren Zeichenfolgen	SMS_Client_Reg_MultiString_List Server WMI-Klasse (Array)

Diese Dokumentation enthält das folgende Thema, in dem die eingebetteten Eigenschaften beschrieben werden:

Lesen einer Configuration Manager Eingebetteten Eigenschaftenliste für Die Websitesteuerungsdatei

Verwenden der Websitesteuerungsdatei

Der Zugriff auf die Standortsteuerungsdatei hängt davon ab, ob Sie WMI oder den verwalteten Anbieter verwenden.

WMI

Wenn Sie WMI verwenden, verwenden Sie die SMS_SiteControlFile Klassenmethoden, um Änderungen an der Standortsteuerungsdatei zu verwalten. Das Schreiben in die Websitesteuerungsdatei wird mithilfe von kontextbezogenen Sitzungsinformationen verwaltet, die Sie bereitstellen. Dies wird verwendet, um gleichzeitiges Schreiben in die Standortsteuerungsdatei für mehrere Anwendungen zu ermöglichen. Weitere Informationen finden Sie unter How to Read and Write to the Configuration Manager Site Control File by Using WMI If you are read only from the site control file you can query without setting up a session.

Managed Provider

In fast allen Fällen muss Ihr Code keine Änderungen an der Configuration Manager Websitesteuerungsdatei sperren oder committen, da die verwaltete Configuration Manager Bibliothek dies für Sie übernimmt. Daher ist die Programmierung der Configuration Manager-Websitesteuerungsdatei im Wesentlichen identisch mit der Programmierung Configuration Manager-Objekten. Dies unterscheidet sich vom Zugriff auf die Configuration Manager Websitesteuerungsdatei über WMI, bei dem Sie explizit ein Sitzungshandle abrufen und alle von Ihnen vorgenommenen Änderungen committen müssen.

Weitere Informationen finden Sie unter How to Read and Write to the Configuration Manager Site Control File by Using Managed Code.For more information, see How to Read and Write to the Configuration Manager Site Control File by Using Managed Code.For more information, see How to Read and Write to the Configuration Manager Site Control File by Using Managed Code.

Siehe auch

Lesen und Schreiben in die Configuration Manager-Websitesteuerungsdatei mithilfe von verwaltetem Code
Lesen und Schreiben in die Configuration Manager Site Control-Datei mithilfe von WMI