Acerca del archivo de control de sitio Configuration Manager

El control de sitio en Configuration Manager define la configuración de un sitio específico. La configuración de cada sitio se encuentra en la base de datos y se accede a ella a través de Instrumental de administración de Windows (WMI) al trabajar con lenguajes de scripting y a través de la biblioteca proveedor de SMS administrada cuando se trabaja con un lenguaje administrado.

Nota:

Las versiones anteriores de Configuration Manager tenían un archivo físico que se procesó para la configuración del sitio denominada archivo de control de sitio. Configuration Manager almacena la configuración del sitio directamente en la base de datos del sitio; sin embargo, muy poco ha cambiado al configurar un sitio mediante programación.

El archivo de control de sitio de Configuration Manager es un archivo de texto ASCII (Sitectrl.ct0) que contiene la configuración de cada sitio. Hay dos tipos de archivos de control de sitio:

• Archivo de control de sitio real: una copia de trabajo del archivo de control de sitio que se almacena en la base de datos de sitio Configuration Manager y en la bandeja de entrada del administrador de control de sitio.

• Archivo de control de sitio delta: contiene los cambios propuestos en el archivo de control de sitio que se van a procesar.

  El archivo de control de sitio se almacena en cada servidor de sitio en la bandeja de entrada del administrador de control de sitio.

  En el sitio principal, hay una copia del archivo de control de sitio para el sitio actual en la base de datos. El sitio primario también tiene una copia del archivo de control de sitio para todos los sitios de nivel inferior de la jerarquía, incluidos los sitios secundarios.

  Cada sitio secundario pasa una copia de su archivo de control de sitio a su sitio primario. Cada sitio primario pasa una copia del archivo de control de sitio para sí mismo y para cada uno de sus sitios secundarios en la jerarquía. Por lo tanto, la base de datos del sitio central contiene copias de los archivos de control de sitio de cada sitio Configuration Manager de la jerarquía.

Formato de archivo de control de sitio

El archivo de control de sitio es una colección de definiciones de recursos que contienen propiedades incrustadas, listas de propiedades incrustadas y listas de varias cadenas. En el ejemplo siguiente se muestra una sección del archivo de control de sitio que define la información del componente de cliente. El recurso lo declara el BEGIN_CLIENT_COMPONENT. Las propiedades incrustadas se indican mediante PROPERTY y tienen un nombre y un valor. Las listas de propiedades se indican mediante la sección BEGIN_PROPERTY_LIST y enumeran un nombre de lista de propiedades y varios nombres de propiedad y valores asociados. Las listas de cadenas múltiples se indican mediante el BEGIN_CLIENT_REG_MULTI_STRING_LIST y proporcionan una lista de valores de cadena.

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  

El proveedor tiene varias clases de Instrumental de administración de Windows (WMI) que representan recursos en el archivo de control de sitio. Por ejemplo, SMS_SCI_Component clase WMI de servidor contiene información sobre los componentes del servidor almacenados en un servidor de sitio Configuration Manager. Estas clases derivan de SMS_SiteControlItem clase WMI de servidor. Para obtener más información, vea Configuration Manager clases WMI de servidor de configuración de sitio [referencia].

El ejemplo siguiente es la declaración de SMS_SCI_ClientConfig clase WMI de servidor.

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

La declaración incluye declaraciones para las declaraciones de la propiedad incrustada, la lista de propiedades y la lista de cadenas múltiples.

Puede acceder a las propiedades incrustadas, las listas de propiedades y las listas de cadenas múltiples mediante las clases siguientes:

Tipo	Clase WMI
Embedded (propiedad)	SMS_EmbeddedProperty clase WMI de servidor
Lista de propiedades incrustadas	SMS_EmbeddedPropertyList clase WMI de servidor (matriz)
Lista de cadenas múltiples	SMS_Client_Reg_MultiString_List clase WMI de servidor (matriz)

Esta documentación tiene el tema siguiente que describe las propiedades incrustadas:

Cómo leer una lista de propiedades incrustadas Configuration Manager archivo de control de sitio

Uso del archivo de control de sitio

La forma de acceder al archivo de control de sitio varía en función de si usa WMI o el proveedor administrado.

WMI

Cuando se usa WMI, se usan los métodos de SMS_SiteControlFile clase para administrar los cambios en el archivo de control de sitio. La escritura en el archivo de control de sitio se administra mediante la información contextual de sesión que proporcione. Esto se usa para habilitar la escritura simultánea en el archivo de control de sitio para varias aplicaciones. Para obtener más información, vea How to Read and Write to the Configuration Manager Site Control File by Using WMI If you are only reading from the site control file you can query it without configure a session.

Proveedor de datos administrados

En casi todos los casos, el código no tiene que bloquear ni confirmar cambios en el archivo de control de sitio Configuration Manager porque la biblioteca de Configuration Manager administrada se encarga de esto. Como resultado, programar el archivo de control de sitio Configuration Manager es fundamentalmente lo mismo que programar Configuration Manager objetos. Esto es diferente del acceso al archivo de control de sitio Configuration Manager a través de WMI, donde tiene que obtener explícitamente un identificador de sesión y confirmar los cambios que realice.

Para obtener más información, vea How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Cómo leer y escribir en el archivo de control de sitio de Configuration Manager mediante código administrado).

Consulta también

Cómo leer y escribir en el archivo de control de sitio de Configuration Manager mediante código administrado
Lectura y escritura en el archivo de control de sitio de Configuration Manager mediante WMI