Lesen einer Configuration Manager Eingebetteten Eigenschaftenliste für Die Websitesteuerungsdatei

Artikel
04/04/2023

In Configuration Manager lesen Sie eine eingebettete Eigenschaftenliste aus einer Websitesteuerungsdateiressource, indem Sie das SMS_EmbeddedPropertyList -Objekt für das eingebettete Objekt aus dem Resource PropLists-Eigenschaftenarray abrufen.

Eine Liste eingebetteter Eigenschaften enthält die folgenden Eigenschaften, die Sie festlegen können. Weitere Informationen finden Sie unter SMS_EmbeddedPropertyList.

Wert	Beschreibung
PropertyListName	Der Name der eingebetteten Eigenschaft.
Werte	Ein Array von Zeichenfolgenwerten. Jedes Arrayelement stellt ein einzelnes Eigenschaftenlistenelement dar.

Achtung

Änderungen an der Websitesteuerungsdatei können irreparable Schäden an Ihrer Configuration Manager Website verursachen.

So lesen Sie eine eingebettete Eigenschaftenliste für eine Websitesteuerelementdatei

Richten Sie eine Verbindung mit dem SMS-Anbieter ein. Weitere Informationen finden Sie unter Grundlagen des SMS-Anbieters.
Rufen Sie mithilfe des Verbindungsobjekts aus Schritt 1 eine Websitesteuerungsdateiressource ab. Weitere Informationen finden Sie unter Informationen zur Configuration Manager Websitesteuerungsdatei.
Rufen Sie die SMS_EmbeddedPropertyList für die erforderliche Liste eingebetteter Eigenschaften ab.
Greifen Sie mithilfe des Values-Eigenschaftenarrays des Objekts auf die SMS_EmbeddedPropertyList Werteliste zu.

Beispiel

Die folgende Beispielmethode füllt den angegebenen values Parameter mit dem Array Values der eingebetteten Eigenschaft SMS_EmbeddedPropertyList auf, die durch den propertyListName -Parameter identifiziert wird. true wird zurückgegeben, wenn die Liste der eingebetteten Eigenschaften gefunden wird. false andernfalls wird zurückgegeben.

Informationen zum Anzeigen von Code, der diese Funktionen aufruft, finden Sie unter How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Lesen und Schreiben in die Configuration Manager Site Control-Datei mithilfe von WMI).

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration Manager Codeausschnitten.


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;  

}

Die Beispielmethode verfügt über die folgenden Parameter:

Parameter	Typ	Beschreibung
`Resource`	-Verwalteten: `IResultObject` – VBScript: SWbemObject	Die Websitesteuerungsdateiressource, die die eingebettete Eigenschaft enthält.
`propertyListName`	-Verwalteten: `String` -Vbscript: `String`	Die liste der zu lesenden eingebetteten Eigenschaften.
`Values`	– Verwaltet: `String` Array – VBScript: `String` Array	Die `SMS_EmbeddedProperty` Values-Eigenschaft der Klasse. Ein Array von Zeichenfolgenwerten.

Kompilieren des Codes

Das C#-Beispiel hat die folgenden Kompilierungsanforderungen:

Namespaces

System

System.Collections.Generic

System.Collections

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robuste Programmierung

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager Fehlern.

.NET Framework-Sicherheit

Weitere Informationen zum Schützen Configuration Manager Anwendungen finden Sie unter Configuration Manager rollenbasierte Verwaltung.

Siehe auch

Informationen zur Configuration Manager-Websitesteuerungsdatei
Lesen und Schreiben in die Configuration Manager-Websitesteuerungsdatei mithilfe von verwaltetem Code
Lesen und Schreiben in die Configuration Manager Site Control-Datei mithilfe von WMI

Teilen über