Informacje o pliku kontrolki lokacji Configuration Manager

Kontrolka lokacji w Configuration Manager definiuje ustawienia określonej witryny. Ustawienia dla każdej lokacji są zawarte w bazie danych i są dostępne za pośrednictwem instrumentacji zarządzania windows (WMI) podczas pracy z językami skryptów oraz za pośrednictwem biblioteki zarządzanego dostawcy programu SMS podczas pracy z językiem zarządzanym.

Uwaga

Poprzednie wersje Configuration Manager miały plik fizyczny, który został przetworzony dla ustawień lokacji nazywanych plikiem kontroli lokacji. Configuration Manager przechowuje ustawienia lokacji bezpośrednio w bazie danych lokacji. Jednak podczas programowego konfigurowania lokacji niewiele się zmieniło.

Plik kontrolki lokacji w Configuration Manager jest plikiem tekstowym ASCII (Sitectrl.ct0), który zawiera konfigurację każdej lokacji. Istnieją dwa typy plików kontroli lokacji:

• Rzeczywisty plik kontroli lokacji — robocza kopia pliku kontroli lokacji przechowywana w bazie danych lokacji Configuration Manager i w skrzynce odbiorczej w menedżerze kontroli lokacji.

• Plik kontroli lokacji różnicowej — zawiera proponowane zmiany w pliku kontroli lokacji, które mają zostać przetworzone.

  Plik kontroli lokacji jest przechowywany na każdym serwerze lokacji w skrzynce odbiorczej menedżera kontroli lokacji.

  W lokacji głównej znajduje się kopia pliku kontroli lokacji dla bieżącej lokacji w bazie danych. Lokacja główna ma również kopię pliku kontroli lokacji dla wszystkich lokacji niższego poziomu w hierarchii, w tym lokacji dodatkowych.

  Każda lokacja podrzędna przekazuje kopię pliku kontroli lokacji do swojej lokacji nadrzędnej. Każda lokacja nadrzędna przekazuje kopię pliku kontroli lokacji dla siebie i dla każdej lokacji podrzędnej w hierarchii. W związku z tym baza danych lokacji centralnej zawiera kopie plików kontroli lokacji każdej Configuration Manager lokacji w hierarchii.

Format pliku kontrolki lokacji

Plik kontroli lokacji to zbiór definicji zasobów zawierających właściwości osadzone, osadzone listy właściwości i listy wielociągowe. W poniższym przykładzie przedstawiono sekcję pliku kontroli lokacji, która definiuje informacje o składnikach klienta. Zasób jest zadeklarowany przez BEGIN_CLIENT_COMPONENT. Właściwości osadzone są oznaczane przez właściwość i mają nazwę i wartość. Listy właściwości są oznaczane przez sekcję BEGIN_PROPERTY_LIST i zawierają listę nazw listy właściwości oraz kilka nazw właściwości i skojarzonych wartości. Listy z wieloma ciągami są oznaczane przez BEGIN_CLIENT_REG_MULTI_STRING_LIST i zawierają listę wartości ciągu.

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  

Dostawca ma kilka klas instrumentacji zarządzania windows (WMI), które reprezentują zasoby w pliku kontroli lokacji. Na przykład klasa WMI serwera SMS_SCI_Component przechowuje informacje o składnikach serwera przechowywanych na serwerze lokacji Configuration Manager. Te klasy pochodzą z klasy WMI serwera SMS_SiteControlItem. Aby uzyskać więcej informacji, zobacz Configuration Manager Klasy WMI serwera konfiguracji lokacji [odwołanie].

Poniższy przykład to deklaracja klasy WMI serwera 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;  
};  

Deklaracja zawiera deklaracje dla właściwości osadzonej, listy właściwości i deklaracji listy wielu ciągów.

Dostęp do osadzonych właściwości, list właściwości i list wielociągowych można uzyskać przy użyciu następujących klas:

Wpisać	Klasa WMI
Właściwość Embedded	SMS_EmbeddedProperty Server WMI Class
Lista właściwości osadzonych	klasa WMI serwera SMS_EmbeddedPropertyList (tablica)
Lista z wieloma ciągami	SMS_Client_Reg_MultiString_List Server WMI Class (tablica)

Ta dokumentacja zawiera następujący temat opisujący właściwości osadzone:

Jak odczytać listę właściwości osadzonych plików kontrolek lokacji Configuration Manager

Korzystanie z pliku kontrolki lokacji

Sposób uzyskiwania dostępu do pliku kontroli lokacji różni się w zależności od tego, czy używasz usługi WMI, czy dostawcy zarządzanego.

Usługa WMI

W przypadku korzystania z usługi WMI metody SMS_SiteControlFile klasy służą do zarządzania zmianami w pliku kontroli lokacji. Zapisywanie w pliku kontroli lokacji jest zarządzane przy użyciu podanych informacji kontekstowych sesji. Służy to do włączania równoczesnego zapisywania w pliku kontroli lokacji dla wielu aplikacji. Aby uzyskać więcej informacji, zobacz 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 setting up a session (Jak odczytywać i zapisywać w Configuration Manager pliku kontroli lokacji przy użyciu usługi WMI, jeśli odczytujesz tylko z pliku kontrolki lokacji), możesz wykonać zapytanie bez konfigurowania sesji.

Dostawca zarządzany

W prawie wszystkich przypadkach kod nie musi blokować ani zatwierdzać zmian w pliku kontroli Configuration Manager lokacji, ponieważ zarządzana biblioteka Configuration Manager zajmuje się tym za Ciebie. W rezultacie programowanie pliku kontroli Configuration Manager lokacji jest zasadniczo takie samo jak programowanie Configuration Manager obiektów. Różni się to od uzyskiwania dostępu do pliku kontroli Configuration Manager lokacji za pośrednictwem usługi WMI, gdzie jawnie trzeba uzyskać dojście sesji i zatwierdzić wszelkie wprowadzone zmiany.

Aby uzyskać więcej informacji, zobacz How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Jak odczytywać i zapisywać w pliku kontroli lokacji Configuration Manager przy użyciu kodu zarządzanego).

Zobacz też

Jak odczytywać i zapisywać w pliku kontroli lokacji Configuration Manager przy użyciu kodu zarządzanego
Jak odczytywać i zapisywać w pliku kontroli lokacji Configuration Manager przy użyciu usługi WMI