À propos du fichier de contrôle de site Configuration Manager
Le contrôle de site dans Configuration Manager définit les paramètres d’un site spécifique. Les paramètres de chaque site sont contenus dans la base de données et sont accessibles via WMI (Windows Management Instrumentation) lorsque vous utilisez des langages de script, et via la bibliothèque de fournisseur SMS managée lorsque vous utilisez un langage managé.
Remarque
Les versions précédentes de Configuration Manager avaient un fichier physique qui a été traité pour les paramètres de site appelé fichier de contrôle de site. Configuration Manager stocke les paramètres de site directement dans la base de données du site ; toutefois, très peu de modifications ont été apportées lors de la configuration programmatique d’un site.
Le fichier de contrôle de site dans Configuration Manager est un fichier texte ASCII (Sitectrl.ct0) qui contient la configuration de chaque site. Il existe deux types de fichiers de contrôle de site :
Fichier de contrôle de site réel : copie de travail du fichier de contrôle de site stocké dans la base de données de site Configuration Manager et dans la boîte de réception du gestionnaire de contrôle de site.
Fichier de contrôle de site delta : contient les modifications de fichier de contrôle de site proposées qui doivent être traitées.
Le fichier de contrôle de site est stocké sur chaque serveur de site dans la boîte de réception du gestionnaire de contrôle de site.
Sur le site principal, il existe une copie du fichier de contrôle de site pour le site actuel dans la base de données. Le site principal dispose également d’une copie du fichier de contrôle de site pour tous les sites de niveau inférieur dans la hiérarchie, y compris les sites secondaires.
Chaque site enfant transmet une copie de son fichier de contrôle de site à son site parent. Chaque site parent transmet une copie du fichier de contrôle de site pour lui-même et pour chacun de ses sites enfants dans la hiérarchie. Par conséquent, la base de données du site central contient des copies des fichiers de contrôle de site de chaque Configuration Manager site dans la hiérarchie.
Format de fichier de contrôle de site
Le fichier de contrôle de site est une collection de définitions de ressources qui contiennent des propriétés incorporées, des listes de propriétés incorporées et des listes à chaînes multiples. L’exemple suivant montre une section du fichier de contrôle de site qui définit les informations de composant client. La ressource est déclarée par le BEGIN_CLIENT_COMPONENT. Les propriétés incorporées sont désignées par PROPERTY et ont un nom et une valeur. Les listes de propriétés sont indiquées par la section BEGIN_PROPERTY_LIST et répertorient un nom de liste de propriétés et plusieurs noms de propriétés et valeurs associées. Les listes à plusieurs chaînes sont indiquées par la BEGIN_CLIENT_REG_MULTI_STRING_LIST et fournissent une liste de valeurs de chaîne.
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
Le fournisseur a plusieurs classes WMI (Windows Management Instrumentation) qui représentent des ressources dans le fichier de contrôle de site. Par exemple, la classe WMI SMS_SCI_Component Server contient des informations sur les composants serveur stockés sur un serveur de site Configuration Manager. Ces classes dérivent de la classe WMI SMS_SiteControlItem Server. Pour plus d’informations, consultez classes WMI du serveur de configuration de site Configuration Manager [référence].
L’exemple suivant est la déclaration de SMS_SCI_ClientConfig Server WMI Class.
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 déclaration inclut des déclarations pour la propriété incorporée, la liste de propriétés et les déclarations de liste à chaînes multiples.
Vous accédez aux propriétés incorporées, aux listes de propriétés et aux listes à plusieurs chaînes à l’aide des classes suivantes :
| Type | WMI, classe |
|---|---|
| Propriété incorporée | Classe WMI du serveur SMS_EmbeddedProperty |
| Liste de propriétés incorporées | classe WMI du serveur SMS_EmbeddedPropertyList (tableau) |
| Liste de chaînes multiples | Classe WMI du serveur SMS_Client_Reg_MultiString_List (tableau) |
Cette documentation contient la rubrique suivante qui décrit les propriétés incorporées :
Utilisation du fichier de contrôle de site
La façon dont vous accédez au fichier de contrôle de site varie selon que vous utilisez WMI ou le fournisseur managé.
WMI
Lorsque vous utilisez WMI, vous utilisez les méthodes de SMS_SiteControlFile classe pour gérer les modifications apportées au fichier de contrôle de site. L’écriture dans le fichier de contrôle de site est gérée à l’aide des informations contextuelles de session que vous fournissez. Cela permet d’activer l’écriture simultanée dans le fichier de contrôle de site pour plusieurs applications. Pour plus d’informations, consultez Guide pratique pour lire et écrire dans le fichier de contrôle de site Configuration Manager à l’aide de WMI Si vous lisez uniquement à partir du fichier de contrôle de site, vous pouvez l’interroger sans configurer de session.
Fournisseur managé
Dans presque tous les cas, votre code n’a pas besoin de verrouiller ou de valider les modifications apportées au fichier de contrôle de site Configuration Manager, car la bibliothèque de Configuration Manager managée s’en occupe pour vous. Par conséquent, la programmation du fichier de contrôle de site Configuration Manager est fondamentalement identique à la programmation d’objets Configuration Manager. Cela diffère de l’accès au fichier de contrôle de site Configuration Manager via WMI où vous devez explicitement obtenir un handle de session et valider les modifications que vous apportez.
Pour plus d’informations, consultez How to Read and Write to the Configuration Manager Site Control File by Using Managed Code.
Voir aussi
Guide pratique pour lire et écrire dans le fichier de contrôle de site Configuration Manager à l’aide de code managé
Guide pratique pour lire et écrire dans le fichier de contrôle de site Configuration Manager à l’aide de WMI