Чтение внедренного списка свойств файла элемента управления сайтом Configuration Manager

Статья
04/04/2023

В Configuration Manager вы считываете внедренный список свойств из ресурса файла элемента управления сайтом, получая объект SMS_EmbeddedPropertyList для внедренного объекта из массива свойств PropLists resources.

Внедренный список свойств содержит следующие свойства, которые можно задать. Дополнительные сведения см. в разделе SMS_EmbeddedPropertyList.

Значение	Описание
PropertyListName	Имя внедренного свойства.
Значения	Массив строковых значений. Каждый элемент массива представляет один элемент списка свойств.

Предостережение

Внесение изменений в файл элемента управления сайтом может нанести непоправимый ущерб вашему Configuration Manager сайту.

Чтение внедренного списка свойств файла элемента управления сайтом

Настройте подключение к поставщику SMS. Дополнительные сведения см. в статье Основы поставщика SMS.
Используя объект подключения из шага 1, получите ресурс файла элемента управления сайтом. Дополнительные сведения см. в разделе Сведения о файле Configuration Manager элемента управления сайтом.
SMS_EmbeddedPropertyList Получите для требуемого внедренного списка свойств.
Доступ к значениям списка свойств можно получить с помощью массива SMS_EmbeddedPropertyList свойств Object Values .

Пример

В следующем примере метод заполняет предоставленный values параметр массивом Values списка SMS_EmbeddedPropertyList внедренных свойств, определяемого параметром propertyListName . true возвращается при обнаружении внедренного списка свойств; false В противном случае возвращается значение .

Чтобы просмотреть код, вызывающий эти функции, см. статью Чтение и запись в файл Configuration Manager элемента управления сайтом с помощью управляемого кода или Как считывать и записывать в файл Configuration Manager элемента управления сайтом с помощью 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;  

}

Пример метода имеет следующие параметры:

Параметр	Тип	Описание
`Resource`	-Управляемых: `IResultObject` — VBScript: SWbemObject	Ресурс файла элемента управления сайтом, содержащий внедренное свойство.
`propertyListName`	-Управляемых: `String` -Vbscript: `String`	Список внедренных свойств для чтения.
`Values`	— Управляемый: `String` массив — VBScript: `String` массив	Свойство `SMS_EmbeddedProperty` класса Values. Массив строковых значений.

Компиляция программы

Пример C# имеет следующие требования к компиляции:

Пространства имен

System;

System.Collections.Generic;

System.Collections

System.Text

Майкрософт. ConfigurationManagement.ManagementProvider

Майкрософт. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Надежное программирование

Дополнительные сведения об обработке ошибок см. в разделе Сведения об ошибках Configuration Manager.

Безопасность .NET Framework

Дополнительные сведения о защите приложений Configuration Manager см. в статье Configuration Manager администрирование на основе ролей.

См. также

Сведения о файле элемента управления сайтом Configuration Manager
Чтение и запись в файл управления сайтом Configuration Manager с помощью управляемого кода
Чтение и запись в файл элемента управления сайтом Configuration Manager с помощью WMI

Поделиться через