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 月臺控制檔案