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

發行項
04/04/2023

在Configuration Manager中，您可以從資源PropLists屬性陣列取得内嵌物件的SMS_EmbeddedPropertyList物件，以從月臺控制檔案資源讀取內嵌屬性清單。

內嵌屬性清單具有您可以設定的下列屬性。如需詳細資訊，請參閱 SMS_EmbeddedPropertyList。

值	描述
PropertyListName	內嵌屬性名稱。
值	字串值的陣列。每個陣列專案都代表單一屬性清單專案。

注意

變更月臺控制檔案可能會對您的Configuration Manager網站造成無法修復的損害。

讀取網站控制檔案內嵌屬性清單

設定與 SMS 提供者的連線。如需詳細資訊，請參閱 SMS 提供者基本概念。
使用步驟 1 中的連線物件，取得月臺控制檔案資源。如需詳細資訊，請參閱關於Configuration Manager月臺控制檔案。
SMS_EmbeddedPropertyList取得必要內嵌屬性清單的。
使用物件 Values屬性陣列來 SMS_EmbeddedPropertyList 存取屬性清單值。

範例

下列範例方法會在提供的 values 參數中填入參數所識別之內嵌屬性清單 SMS_EmbeddedPropertyList 的 propertyListNameValues陣列。 true 如果找到內嵌屬性清單，則會傳回 ;否則會 false 傳回。

若要檢視呼叫這些函式的程式碼，請參閱How to Read and Write to the Configuration Manager Site Control File by Using Managed Code or see How to Read and Write to the Configuration Manager Site Control File by Using WMI。

如需呼叫範例程式碼的相關資訊，請參閱呼叫Configuration Manager程式碼片段。


Function GetScfEmbeddedPropertyList(resource,  _  
        propertyListName,               _  
        ByRef values)  

    Dim scfPropertyList  

    If IsNull(resource.PropLists) = True Then  
        GetScfPropertyList = False  
        Exit Function  
    End If      

    For each scfPropertyList in resource.PropLists  
       if   scfPropertyList.PropertyListName = propertyListName Then  
            ' Found property list, so return the values array.  
            values = scfPropertyList.Values  
            GetScfEmbeddedPropertyList = True  
            Exit Function  
        End If  
     Next    

     ' Did not find the property list.  
     GetScfEmbeddedPropertyList = False  
End Function

public bool GetScfEmbeddedPropertyList(  
    IResultObject resource,  
    string propertyListName,  
    out ArrayList values)  
{  
    values = new ArrayList();  
    try  
    {  
        if (resource.EmbeddedPropertyLists.ContainsKey(propertyListName))  
        {  
            values.AddRange(resource.EmbeddedPropertyLists[propertyListName]["Values"].StringArrayValue);  
            return true;  
        }  
    }  
    catch(SmsException e)  
    {  
        Console.WriteLine("Couldn't get the embedded property list: " + e.Message);  
    }  
    return false;  

}

範例方法具有下列參數：

參數	Type	描述
`Resource`	-管理： `IResultObject` - VBScript： SWbemObject	包含內嵌屬性的月臺控制檔案資源。
`propertyListName`	-管理： `String` - VBScript： `String`	要讀取的內嵌屬性清單。
`Values`	- Managed： `String` 陣列 - VBScript： `String` 陣列	Values `SMS_EmbeddedProperty` 類別屬性。字串值的陣列。

正在編譯程式碼

C# 範例具有下列編譯需求：

命名空間

系統

System.Collections.Generic

System.Collections

System.Text

Microsoft。ConfigurationManagement.ManagementProvider

Microsoft。ConfigurationManagement.ManagementProvider.WqlQueryEngine

組件

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

健全的程式設計

如需錯誤處理的詳細資訊，請參閱關於Configuration Manager錯誤。

.NET Framework 安全性

如需保護Configuration Manager應用程式的詳細資訊，請參閱Configuration Manager角色型系統管理。

另請參閱

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

共用方式為