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

W Configuration Manager odczytasz osadzoną listę właściwości z zasobu pliku kontroli lokacji, uzyskując obiekt SMS_EmbeddedPropertyList dla obiektu osadzonego z tablicy właściwości proplists zasobów.

Lista właściwości osadzonych ma następujące właściwości, które można ustawić. Aby uzyskać więcej informacji, zobacz SMS_EmbeddedPropertyList.

Value	Opis
PropertyListName	Nazwa właściwości osadzonej.
Wartości	Tablica wartości ciągu. Każdy element tablicy reprezentuje pojedynczy element listy właściwości.

Uwaga

Wprowadzenie zmian w pliku kontroli lokacji może spowodować nieodwracalne uszkodzenie witryny Configuration Manager.

Aby odczytać listę właściwości osadzonych pliku kontrolki lokacji

1. Skonfiguruj połączenie z dostawcą programu SMS. Aby uzyskać więcej informacji, zobacz Podstawy dostawcy programu SMS.

2. Korzystając z obiektu połączenia z kroku 1, pobierz zasób pliku kontroli lokacji. Aby uzyskać więcej informacji, zobacz About the Configuration Manager Site Control File (Informacje o pliku kontroli lokacji Configuration Manager).

3. Pobierz listę SMS_EmbeddedPropertyList wymaganych właściwości osadzonych.

4. Uzyskiwanie dostępu do wartości listy właściwości przy użyciu tablicy właściwości Values obiektuSMS_EmbeddedPropertyList.

Przykład

Poniższa przykładowa metoda wypełnia podany values parametr tablicą Wartości na liście SMS_EmbeddedPropertyList właściwości osadzonych identyfikowanej przez propertyListName parametr. true jest zwracana, jeśli zostanie znaleziona lista właściwości osadzonych; false w przeciwnym razie jest zwracany.

Aby wyświetlić kod wywołujący te funkcje, zobacz How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Jak odczytywać izapisywać w pliku kontroli lokacji Configuration Manager przy użyciu usługi WMI).

Aby uzyskać informacje na temat wywoływania przykładowego kodu, zobacz Wywoływanie fragmentów kodu 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;  

}  

Przykładowa metoda ma następujące parametry:

Parametr	Wpisać	Opis
Resource	-Zarządzane: IResultObject - VBScript: SWbemObject	Zasób pliku kontrolki lokacji, który zawiera właściwość osadzoną.
propertyListName	-Zarządzane: String -Vbscript: String	Lista właściwości osadzonych do odczytu.
Values	- Zarządzane: String tablica - VBScript: String tablica	Właściwość SMS_EmbeddedProperty Values klasy. Tablica wartości ciągu.

Kompilowanie kodu

Przykład języka C# ma następujące wymagania dotyczące kompilacji:

Obszary nazw

System

System.collections.generic

System.collections

System.text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Zestawu

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Niezawodne programowanie

Aby uzyskać więcej informacji na temat obsługi błędów, zobacz Informacje o błędach Configuration Manager.

zabezpieczenia .NET Framework

Aby uzyskać więcej informacji na temat zabezpieczania aplikacji Configuration Manager, zobacz Configuration Manager administracja oparta na rolach.

Zobacz też

Informacje o pliku kontrolki lokacji Configuration Manager
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