Informazioni sul file di controllo del sito Configuration Manager

Il controllo sito in Configuration Manager definisce le impostazioni per un sito specifico. Le impostazioni per ogni sito sono contenute nel database e sono accessibili tramite Strumentazione gestione Windows (WMI) quando si usano i linguaggi di scripting e tramite la libreria del provider SMS gestita quando si usa un linguaggio gestito.

Nota

Nelle versioni precedenti di Configuration Manager era stato elaborato un file fisico per le impostazioni del sito denominato file di controllo del sito. Configuration Manager archivia le impostazioni del sito direttamente nel database del sito; tuttavia, quando si configura un sito a livello di codice, le modifiche sono molto poche.

Il file di controllo del sito in Configuration Manager è un file di testo ASCII (Sitectrl.ct0) che contiene la configurazione di ogni sito. Esistono due tipi di file di controllo del sito:

  • File di controllo del sito effettivo: copia funzionante del file di controllo del sito archiviato nel database del sito Configuration Manager e nella posta in arrivo in Gestione controllo sito.

  • File di controllo del sito delta: contiene le modifiche al file di controllo del sito proposte che devono essere elaborate.

    Il file di controllo del sito viene archiviato in ogni server del sito nella posta in arrivo di Gestione controllo sito.

    Nel sito primario è presente una copia del file di controllo del sito per il sito corrente nel database. Il sito primario ha anche una copia del file di controllo del sito per tutti i siti di livello inferiore nella gerarchia, inclusi i siti secondari.

    Ogni sito figlio passa una copia del relativo file di controllo del sito al sito padre. Ogni sito padre passa una copia del file di controllo del sito per se stesso e per ogni sito figlio nella gerarchia. Pertanto, il database del sito centrale contiene copie dei file di controllo del sito di ogni sito Configuration Manager nella gerarchia.

Formato file controllo sito

Il file di controllo del sito è una raccolta di definizioni di risorse che contengono proprietà incorporate, elenchi di proprietà incorporate ed elenchi a più stringhe. Nell'esempio seguente viene illustrata una sezione del file di controllo del sito che definisce le informazioni sui componenti client. La risorsa viene dichiarata dal BEGIN_CLIENT_COMPONENT. Le proprietà incorporate sono indicate da PROPERTY e hanno un nome e un valore. Gli elenchi di proprietà sono indicati dalla sezione BEGIN_PROPERTY_LIST ed elencano un nome elenco di proprietà e diversi nomi di proprietà e valori associati. Gli elenchi a più stringhe sono indicati dal BEGIN_CLIENT_REG_MULTI_STRING_LIST e forniscono un elenco di valori stringa.

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  

Il provider dispone di diverse classi WMI (Windows Management Instrumentation) che rappresentano le risorse nel file di controllo del sito. Ad esempio, SMS_SCI_Component classe WMI del server contiene informazioni sui componenti del server archiviati in un server del sito Configuration Manager. Queste classi derivano da SMS_SiteControlItem classe WMI server. Per altre informazioni, vedere Configuration Manager Classi WMI del server di configurazione del sito [riferimento].

L'esempio seguente è la dichiarazione per SMS_SCI_ClientConfig classe WMI del server.

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 dichiarazione include dichiarazioni per le dichiarazioni di proprietà incorporate, elenco di proprietà e elenco di più stringhe.

È possibile accedere alle proprietà incorporate, agli elenchi di proprietà e agli elenchi a più stringhe usando le classi seguenti:

Tipo Classe WMI
Proprietà incorporata Classe WMI del server SMS_EmbeddedProperty
Elenco di proprietà incorporate Classe WMI del server SMS_EmbeddedPropertyList (matrice)
Elenco a più stringhe Classe WMI del server SMS_Client_Reg_MultiString_List (matrice)

Questa documentazione include l'argomento seguente che descrive le proprietà incorporate:

Come leggere un elenco di proprietà incorporate di un file di controllo del sito Configuration Manager

Uso del file di controllo del sito

La modalità di accesso al file di controllo del sito varia a seconda che si usi WMI o il provider gestito.

WMI

Quando si usa WMI, si usano i metodi di SMS_SiteControlFile classe per gestire le modifiche al file di controllo del sito. La scrittura nel file di controllo del sito viene gestita usando le informazioni contestuali della sessione fornite. Viene usato per abilitare la scrittura simultanea nel file di controllo del sito per più applicazioni. Per altre informazioni, vedere How to Read and Write to the Configuration Manager Site Control File by Using WMI (Come leggere e scrivere nel file di controllo del sito Configuration Manager usando WMI) Se si sta leggendo solo dal file di controllo del sito, è possibile eseguire query senza configurare una sessione.

Provider gestito

In quasi tutti i casi, il codice non deve bloccare o eseguire il commit delle modifiche al file di controllo del sito Configuration Manager perché la libreria di Configuration Manager gestita si occupa automaticamente di questo aspetto. Di conseguenza, la programmazione del file di controllo del sito Configuration Manager è fondamentalmente la stessa della programmazione di oggetti Configuration Manager. Questa operazione è diversa dall'accesso al file di controllo del sito Configuration Manager tramite WMI, in cui è necessario ottenere in modo esplicito un handle di sessione ed eseguire il commit delle modifiche apportate.

Per altre informazioni, vedere How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Come leggere e scrivere nel file di controllo del sito Configuration Manager tramite codice gestito).

Vedere anche

Come leggere e scrivere nel file di controllo del sito Configuration Manager usando codice gestito
Come leggere e scrivere nel file di controllo del sito Configuration Manager tramite WMI