共用方式為


關於Configuration Manager月臺控制檔案

Configuration Manager中的網站控制項會定義特定網站的設定。 每個網站的設定都包含在資料庫中,並且會在使用指令碼語言時透過 Windows Management Instrumentation (WMI) 存取,以及在使用 Managed 語言時透過受管理的 SMS 提供者程式庫存取。

注意事項

舊版的Configuration Manager有一個實體檔案,已針對稱為月臺控制檔案的月臺設定進行處理。 Configuration Manager直接將月臺設定儲存在月臺資料庫中;不過,在以程式設計方式設定月臺時,幾乎不會有變更。

Configuration Manager中的月臺控制檔案是包含每個月臺組態 (Sitectrl.ct0) 的 ASCII 文字檔。 網站控制檔案有兩種類型:

  • 實際的月臺控制檔案 - 月臺控制檔案的工作複本,儲存在月臺控制管理員的Configuration Manager和收件匣中。

  • 差異網站控制檔案 - 包含要處理的建議月臺控制檔案變更。

    月臺控制檔案會儲存在月臺控制管理員收件匣中的每個月臺伺服器上。

    在主要月臺上,資料庫中有目前月臺的月臺控制檔案複本。 主要月臺也有階層中所有較低層級月臺的月臺控制檔案複本,包括次要月臺。

    每個子月臺都會將月臺控制檔案的複本傳遞至其父月臺。 每個父月臺都會針對本身和階層上每個子月臺傳遞月臺控制檔案的複本。 因此,中央月臺的資料庫包含階層中每個Configuration Manager月臺的月臺控制檔案複本。

網站控制檔案格式

月臺控制檔案是資源定義的集合,其中包含內嵌屬性、內嵌屬性清單和多字串清單。 下列範例顯示定義用戶端元件資訊的月臺控制檔案區段。 資源是由BEGIN_CLIENT_COMPONENT宣告。 內嵌屬性會以 PROPERTY 表示,並具有名稱和值。 屬性清單會以BEGIN_PROPERTY_LIST區段來表示,並列出屬性清單名稱,以及數個屬性名稱和相關聯的值。 多字串清單是由BEGIN_CLIENT_REG_MULTI_STRING_LIST所表示,並提供字串值清單。

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  

提供者有數個 Windows Management Instrumentation (WMI) 類別,這些類別代表月臺控制檔案中的資源。 例如,SMS_SCI_Component伺服器 WMI 類別會保存儲存在Configuration Manager月臺伺服器上之伺服器元件的相關資訊。 這些類別衍生自SMS_SiteControlItem Server WMI 類別。 如需詳細資訊,請參閱Configuration Manager月臺設定伺服器 WMI 類別 [參考]

下列範例是 SMS_SCI_ClientConfig Server WMI 類別的宣告。

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;  
};  

宣告包含內嵌屬性、屬性清單和多字串清單宣告的宣告。

您可以使用下列類別來存取內嵌屬性、屬性清單和多字串清單:

類型 WMI 類別
Embedded 屬性 SMS_EmbeddedProperty伺服器 WMI 類別
內嵌屬性清單 SMS_EmbeddedPropertyList伺服器 WMI 類別 (陣列)
多字串清單 SMS_Client_Reg_MultiString_List伺服器 WMI 類別 (陣列)

本檔具有下列主題,描述內嵌屬性:

如何讀取Configuration Manager控制項檔案內嵌屬性清單

使用月臺控制檔案

您存取月臺控制檔案的方式會因您是使用 WMI 或受控提供者而有所不同。

WMI

當您使用 WMI 時,您可以使用 SMS_SiteControlFile 類別方法來管理月臺控制檔案的變更。 寫入月臺控制檔案是使用您提供的會話內容資訊來管理。 這是用來啟用同時寫入多個應用程式的月臺控制檔案。 如需詳細資訊,請參閱How to Read and Write to the Configuration Manager Site Control File by Using WMI If you are only read from the site control file you can query it without setting up a session.

受控提供者

在幾乎所有情況下,您的程式碼都不需要鎖定或認可Configuration Manager月臺控制檔案的變更,因為受控Configuration Manager程式庫會為您處理此問題。 因此,Configuration Manager月臺控制檔案的程式設計基本上與程式設計Configuration Manager物件相同。 這不同于透過 WMI 存取Configuration Manager月臺控制檔案,您必須明確取得會話控制碼並認可您所做的任何變更。

如需詳細資訊,請參閱How to Read and Write to the Configuration Manager Site Control File by Using Managed Code

另請參閱

如何使用 Managed 程式碼讀取和寫入Configuration Manager月臺控制檔案
如何使用 WMI 讀取和寫入Configuration Manager月臺控制檔案