Sobre o arquivo de controle de site Configuration Manager

Artigo
04/04/2023

O controle de site no Configuration Manager define as configurações de um site específico. As configurações de cada site estão contidas no banco de dados e são acessadas por meio da WMI (Instrumentação de Gerenciamento do Windows) ao trabalhar com linguagens de script e por meio da biblioteca gerenciada do Provedor de SMS ao trabalhar com um idioma gerenciado.

Observação

As versões anteriores do Configuration Manager tinham um arquivo físico que foi processado para configurações de site conhecidas como o arquivo de controle do site. Configuration Manager armazena as configurações do site diretamente no banco de dados do site; no entanto, muito pouco mudou ao configurar programaticamente um site.

O arquivo de controle de site no Configuration Manager é um arquivo de texto ASCII (Sitectrl.ct0) que contém a configuração de cada site. Há dois tipos de arquivos de controle de site:

Arquivo de controle de site real – uma cópia de trabalho do arquivo de controle do site que é armazenado no banco de dados do site Configuration Manager e na caixa de entrada no gerenciador de controle do site.
Arquivo de controle de site delta – Contém as alterações de arquivo de controle de site propostas que devem ser processadas.

O arquivo de controle do site é armazenado em cada servidor de site na caixa de entrada do gerenciador de controle do site.

No site primário, há uma cópia do arquivo de controle do site para o site atual no banco de dados. O site primário também tem uma cópia do arquivo de controle de site para todos os sites de nível inferior na hierarquia, incluindo sites secundários.

Cada site filho passa uma cópia de seu arquivo de controle de site para seu site pai. Cada site pai passa uma cópia do arquivo de controle do site para si mesmo e para cada um de seus sites filho até a hierarquia. Portanto, o banco de dados do site central contém cópias dos arquivos de controle de site de cada site Configuration Manager na hierarquia.

Formato de arquivo de controle de site

O arquivo de controle de site é uma coleção de definições de recursos que contêm propriedades inseridas, listas de propriedades inseridas e listas de várias cadeias de caracteres. O exemplo a seguir mostra uma seção do arquivo de controle de site que define informações de componente do cliente. O recurso é declarado pelo BEGIN_CLIENT_COMPONENT. As propriedades inseridas são denotadas por PROPERTY e têm um nome e um valor. As listas de propriedades são denotadas pela seçã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 caracteres são denotadas pelo BEGIN_CLIENT_REG_MULTI_STRING_LIST e fornecem uma lista de valores de cadeia de caracteres.

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 provedor tem várias classes WMI (Instrumentação de Gerenciamento do Windows) que representam recursos no arquivo de controle do site. Por exemplo, SMS_SCI_Component Classe WMI do Servidor contém informações sobre os componentes do servidor armazenados em um servidor de site Configuration Manager. Essas classes derivam da classe WMI do servidor SMS_SiteControlItem. Para obter mais informações, consulte Configuration Manager Classes WMI do Servidor de Configuração de Site [referência].

O exemplo a seguir é a declaração para SMS_SCI_ClientConfig Classe WMI do 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;  
};

A declaração inclui declarações para a propriedade inserida, lista de propriedades e declarações de lista de várias cadeias de caracteres.

Você acessa as propriedades incorporadas, listas de propriedades e listas de várias cadeias de caracteres usando as seguintes classes:

Tipo	Classe WMI
Propriedade inserida	Classe WMI do servidor SMS_EmbeddedProperty
Lista de propriedades inseridas	classe WMI do servidor SMS_EmbeddedPropertyList (matriz)
Lista de várias cadeias de caracteres	classe WMI do servidor SMS_Client_Reg_MultiString_List (matriz)

Essa documentação tem o seguinte tópico que descreve as propriedades inseridas:

Como ler uma lista de propriedades integradas de arquivo de controle de site Configuration Manager

Usando o Arquivo de Controle de Site

A forma como você acessa o arquivo de controle do site difere dependendo se você está usando a WMI ou o provedor gerenciado.

WMI

Ao usar o WMI, você usa os métodos de SMS_SiteControlFile classe para gerenciar alterações no arquivo de controle do site. A gravação no arquivo de controle do site é gerenciada usando informações contextuais de sessão que você fornece. Isso é usado para habilitar a gravação simultânea no arquivo de controle do site para vários aplicativos. Para obter mais informações, consulte Como ler e gravar no Configuration Manager Arquivo de Controle de Site usando o WMI Se você estiver lendo apenas do arquivo de controle do site, poderá consultá-lo sem configurar uma sessão.

provedor gerenciado

Em quase todos os casos, seu código não precisa bloquear ou confirmar alterações no arquivo de controle do site Configuration Manager porque a biblioteca de Configuration Manager gerenciada cuida disso para você. Como resultado, a programação do arquivo de controle de site Configuration Manager é fundamentalmente a mesma que a programação Configuration Manager objetos. Isso é diferente de acessar o arquivo de controle do site Configuration Manager por meio da WMI, em que você precisa obter explicitamente um identificador de sessão e confirmar quaisquer alterações feitas.

Para obter mais informações, consulte Como ler e gravar no arquivo de controle de site Configuration Manager usando código gerenciado.

Confira também

Como ler e gravar no arquivo de controle de site Configuration Manager usando código gerenciado
Como ler e gravar no arquivo de controle de site Configuration Manager usando o WMI

Compartilhar via