Сведения о файле элемента управления сайтом Configuration Manager

Элемент управления сайтом в Configuration Manager определяет параметры для определенного сайта. Параметры для каждого сайта содержатся в базе данных и доступны через инструментарий управления Windows (WMI) при работе с языками сценариев и через управляемую библиотеку поставщика SMS при работе с управляемым языком.

Примечание.

В предыдущих выпусках Configuration Manager был физический файл, который обрабатывался для параметров сайта, называемых файлом управления сайтом. Configuration Manager хранит параметры сайта непосредственно в базе данных сайта, однако при программной настройке сайта очень мало что изменилось.

Файл элемента управления сайтом в Configuration Manager представляет собой текстовый файл ASCII (Sitectrl.ct0), содержащий конфигурацию каждого сайта. Существует два типа файлов элементов управления сайтом:

• Фактический файл элемента управления сайтом — рабочая копия файла элемента управления сайтом, который хранится в базе данных сайта Configuration Manager и в папке "Входящие" в диспетчере элементов управления сайтом.

• Разностный файл элемента управления сайтом — содержит предлагаемые изменения файла элемента управления сайтом, которые необходимо обработать.

  Файл элемента управления сайтом хранится на каждом сервере сайта в папке "Входящие" диспетчера элементов управления сайтом.

  На первичном сайте имеется копия файла управления сайтом для текущего сайта в базе данных. Основной сайт также содержит копию файла управления сайтом для всех сайтов нижнего уровня в иерархии, включая вторичные сайты.

  Каждый дочерний сайт передает копию файла управления сайтом родительскому сайту. Каждый родительский сайт передает копию файла управления сайтом для себя и для каждого из своих дочерних сайтов вверх по иерархии. Таким образом, база данных центрального сайта содержит копии файлов управления сайтом каждого Configuration Manager сайта в иерархии.

Формат файла элемента управления сайтом

Файл элемента управления сайтом представляет собой коллекцию определений ресурсов, содержащих внедренные свойства, внедренные списки свойств и многостроковые списки. В следующем примере показан раздел файла элемента управления сайтом, который определяет сведения о компонентах клиента. Ресурс объявляется BEGIN_CLIENT_COMPONENT. Внедренные свойства обозначаются свойством PROPERTY и имеют имя и значение. Списки свойств обозначаются разделом BEGIN_PROPERTY_LIST и списком имени списка свойств и нескольких имен свойств и связанных значений. Многостроковые списки обозначаются BEGIN_CLIENT_REG_MULTI_STRING_LIST и предоставляют список строковых значений.

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  

Поставщик имеет несколько классов инструментария управления Windows (WMI), которые представляют ресурсы в файле элемента управления сайтом. Например, класс WMI сервера SMS_SCI_Component содержит сведения о компонентах сервера, хранящихся на сервере сайта Configuration Manager. Эти классы являются производными от класса WMI сервера SMS_SiteControlItem. Дополнительные сведения см. в разделе Configuration Manager классы WMI сервера конфигурации сайта [справочник].

В следующем примере показано объявление для класса 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;  
};  

Объявление включает объявления для внедренного свойства, списка свойств и многостроковых объявлений списка.

Доступ к внедренным свойствам, спискам свойств и многостроковым спискам можно получить с помощью следующих классов:

Тип	Класс WMI
Внедренное свойство	Класс WMI сервера SMS_EmbeddedProperty
Внедренный список свойств	класс WMI сервера SMS_EmbeddedPropertyList (массив)
Список с несколькими строками	класс WMI сервера SMS_Client_Reg_MultiString_List (массив)

Эта документация содержит следующий раздел, в котором описываются внедренные свойства:

Чтение внедренного списка свойств файла элемента управления сайтом Configuration Manager

Использование файла элемента управления сайтом

Способ доступа к файлу управления сайтом зависит от того, используется ли WMI или управляемый поставщик.

WMI

При использовании WMI методы класса используются SMS_SiteControlFile для управления изменениями в файле элемента управления сайтом. Запись в файл элемента управления сайтом управляется с помощью предоставленной контекстной информации сеанса. Используется для включения параллельной записи в файл элемента управления сайтом для нескольких приложений. Дополнительные сведения см. в разделе Чтение и запись в файл Configuration Manager элемента управления сайтом с помощью WMI. Если вы читаете только из файла элемента управления сайта, вы можете запрашивать его без настройки сеанса.

управляемый поставщик

Почти во всех случаях коду не требуется блокировать или фиксировать изменения в файле Configuration Manager элемента управления сайтом, так как об этом позаботится управляемая библиотека Configuration Manager. В результате программирование файла элемента управления сайтом Configuration Manager по сути совпадает с программированием Configuration Manager объектов. Это отличается от доступа к файлу управления сайтом Configuration Manager через WMI, где необходимо явно получить дескриптор сеанса и зафиксировать все внесенные изменения.

Дополнительные сведения см. в статье Чтение и запись в файл управления сайтом Configuration Manager с помощью управляемого кода.

См. также

Чтение и запись в файл управления сайтом Configuration Manager с помощью управляемого кода
Чтение и запись в файл элемента управления сайтом Configuration Manager с помощью WMI