Jak odczytać Configuration Manager osadzoną listę właściwości pliku sterowania lokacji

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

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

Wartość 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.

Przestroga

Wprowadzanie zmian w pliku sterowania lokacji może spowodować nieodwracalną szkodę dla witryny Configuration Manager.

Aby odczytać listę właściwości osadzonego pliku sterowania lokacji

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

  2. Przy użyciu obiektu połączenia z kroku jeden Pobierz zasób pliku kontrolnego lokacji. Aby uzyskać więcej informacji, zobacz Informacje o Configuration Manager pliku sterowania lokacji.

  3. Pobierz SMS_EmbeddedPropertyList dla wymaganej listy osadzonych właściwości.

  4. Uzyskaj dostęp do wartości listy właściwości przy użyciu SMS_EmbeddedPropertyList tablicy właściwości wartości obiektów.

Przykład

Poniższa przykładowa Metoda wypełnia podany values parametr z tablicą wartości osadzonej listy właściwości SMS_EmbeddedPropertyList identyfikowanej przez propertyListName parametr. true jest zwracany, jeśli zostanie znaleziona lista osadzonych właściwości. w przeciwnym razie false jest zwracany.

Aby wyświetlić kod, który wywołuje te funkcje, zobacz jak odczytywać i zapisywać dane w pliku sterowania lokacji Configuration Manager przy użyciu kodu zarządzanego lub zobaczyć, jak odczytywać i zapisywać dane w Configuration Manager pliku sterowania lokacji za pomocą usługi WMI.

Aby uzyskać informacje na temat wywoływania przykładowego kodu, zobacz wywoływanie Configuration Manager fragmentów kodu.


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 Typ Opis
Resource Zarządzanych IResultObject
-VBScript: SWbemObject
Zasób pliku sterowania lokacji, który zawiera osadzoną właściwość.
propertyListName Zarządzanych String
VBScript String
Lista osadzonych właściwości do odczytu.
Values — Zarządzane: String Tablica
-VBScript: String Tablica
SMS_EmbeddedPropertyWłaściwość wartości klasy. Tablica wartości ciągu.

Kompilowanie kodu

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

Przestrzenie nazw

System

System.Collections.Generic

System. Collections

System.Text

Microsoft.ConfigurationManagement. ManagementProvider

Microsoft.ConfigurationManagement. ManagementProvider. WqlQueryEngine

Zestaw

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ż

About the Configuration Manager Site Control File (Informacje o pliku sterowania lokacji programu Configuration Manager)
Jak odczytać i zapisać w pliku sterowania lokacji Configuration Manager za pomocą kodu zarządzanego
Jak odczytać i zapisać w pliku sterowania lokacji Configuration Manager przy użyciu usługi WMI