Compartilhar via


Acerca do Ficheiro de Controlo de Sites do Configuration Manager

O controlo do site no Configuration Manager define as definições de um site específico. As definições de cada site estão contidas na base de dados e são acedidas através do Windows Management Instrumentation (WMI) ao trabalhar com linguagens de scripting e através da biblioteca do Fornecedor de SMS gerida ao trabalhar com um idioma gerido.

Observação

As versões anteriores do Configuration Manager tinham um ficheiro físico que foi processado para definições de site referidas como o ficheiro de controlo do site. Configuration Manager armazena as definições do site diretamente na base de dados do site; no entanto, muito pouco mudou ao configurar programaticamente um site.

O ficheiro de controlo do site no Configuration Manager é um ficheiro de texto ASCII (Sitectrl.ct0) que contém a configuração de cada site. Existem dois tipos de ficheiros de controlo de sites:

  • Ficheiro de controlo de site real – uma cópia funcional do ficheiro de controlo do site que está armazenado na base de dados do site Configuration Manager e na caixa de entrada no gestor de controlo do site.

  • Ficheiro de controlo do site Delta - Contém as alterações propostas ao ficheiro de controlo do site que vão ser processadas.

    O ficheiro de controlo do site é armazenado em cada servidor do site na caixa de entrada do gestor de controlo do site.

    No site primário, existe uma cópia do ficheiro de controlo do site para o site atual na base de dados. O site primário também tem uma cópia do ficheiro de controlo do site para todos os sites de nível inferior na hierarquia, incluindo sites secundários.

    Cada site subordinado transmite uma cópia do respetivo ficheiro de controlo de site para o respetivo site principal. Cada site principal transmite uma cópia do ficheiro de controlo do site para si próprio e para cada um dos respetivos sites subordinados na hierarquia. Por conseguinte, a base de dados do site central contém cópias dos ficheiros de controlo do site de cada Configuration Manager site na hierarquia.

Formato de Ficheiro de Controlo de Site

O ficheiro de controlo do site é uma coleção de definições de recursos que contêm propriedades incorporadas, listas de propriedades incorporadas e listas de várias cadeias de carateres. O exemplo seguinte mostra uma secção do ficheiro de controlo do site que define as informações do componente do cliente. O recurso é declarado pelo BEGIN_CLIENT_COMPONENT. As propriedades incorporadas são indicadas por PROPRIEDADE e têm um nome e valor. As listas de propriedades são indicadas pela secção BEGIN_PROPERTY_LIST e listam um nome de lista de propriedades e vários nomes de propriedades e valores associados. As listas de várias cadeias de carateres são indicadas pelo BEGIN_CLIENT_REG_MULTI_STRING_LIST e fornecem uma lista de valores de cadeia.

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  

O fornecedor tem várias classes do Windows Management Instrumentation (WMI) que representam recursos no ficheiro de controlo do site. Por exemplo, SMS_SCI_Component Classe WMI de Servidor contém informações sobre os componentes do servidor armazenados num servidor do Configuration Manager site. Estas classes derivam da Classe WMI de Servidor SMS_SiteControlItem. Para obter mais informações, veja Configuration Manager Classes WMI de Servidor de Configuração do Site [referência].

O exemplo seguinte é a declaração da Classe WMI de Servidor 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;  
};  

A declaração inclui declarações para a propriedade incorporada, lista de propriedades e declarações de lista de cadeias múltiplas.

Pode aceder às propriedades incorporadas, listas de propriedades e listas de várias cadeias com as seguintes classes:

Tipo Classe WMI
Propriedade incorporada Classe WMI de Servidor SMS_EmbeddedProperty
Lista de propriedades incorporadas Classe WMI de Servidor SMS_EmbeddedPropertyList (matriz)
Lista de múltiplas cadeias Classe WMI de Servidor SMS_Client_Reg_MultiString_List (matriz)

Esta documentação tem o seguinte tópico que descreve as propriedades incorporadas:

How to Read a Configuration Manager Site Control File Embedded Property List (Como Ler uma Lista de Propriedades Incorporadas de Ficheiros de Controlo de Sites do Configuration Manager)

Utilizar o Ficheiro de Controlo de Site

A forma como acede ao ficheiro de controlo do site difere consoante esteja a utilizar a WMI ou o fornecedor gerido.

WMI

Quando estiver a utilizar a WMI, utiliza os SMS_SiteControlFile métodos de classe para gerir as alterações ao ficheiro de controlo do site. Escrever no ficheiro de controlo do site é gerido através de informações contextuais de sessão fornecidas por si. Isto é utilizado para ativar a escrita simultânea no ficheiro de controlo do site para várias aplicações. Para obter mais informações, consulte How to Read and Write to the Configuration Manager Site Control File by Using WMI (Como Ler e Escrever no Ficheiro de Controlo de Sites do Configuration Manager através da WMI) Se só estiver a ler a partir do ficheiro de controlo do site, pode consultar sem configurar uma sessão.

provedor gerenciado

Em quase todos os casos, o código não tem de bloquear ou consolidar alterações ao ficheiro de controlo do site Configuration Manager porque a biblioteca de Configuration Manager gerida trata disto automaticamente. Como resultado, a programação do Configuration Manager ficheiro de controlo de site é fundamentalmente igual à programação Configuration Manager objetos. Isto é diferente de aceder ao Configuration Manager ficheiro de controlo de site através da WMI, onde tem explicitamente de obter um identificador de sessão e consolidar as alterações que fizer.

Para obter mais informações, consulte How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Como Ler e Escrever no Ficheiro de Controlo de Sites do Configuration Manager através do Código Gerido).

Confira também

How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Como Ler e Escrever no Ficheiro de Controlo de Sites do Configuration Manager através do Código Gerido)
How to Read and Write to the Configuration Manager Site Control File by Using WMI (Como Ler e Escrever no Ficheiro de Controlo de Sites do Configuration Manager através da WMI)