Vorgehensweise beim Lesen einer Configuration Manager-Standort Steuerungs Datei Embedded-Eigenschaften ListeHow to Read a Configuration Manager Site Control File Embedded Property List

In Configuration Manager lesen Sie eine eingebettete Eigenschaften Liste aus einer Website Steuerungs Datei Ressource, indem Sie das SMS_EmbeddedPropertyList -Objekt für das eingebettete Objekt aus dem Eigenschafts Array "Resources proplists " erhalten.In Configuration Manager, you read an embedded property list from a site control file resource by getting the SMS_EmbeddedPropertyList object for the embedded object from the resources PropLists property array.

Eine eingebettete Eigenschaften Liste verfügt über die folgenden Eigenschaften, die Sie festlegen können.An embedded property list has the following properties that you can set. Weitere Informationen finden Sie unter SMS_EmbeddedPropertyList.For more information, see SMS_EmbeddedPropertyList.

WertValue BESCHREIBUNGDescription
PropertylistnamePropertyListName Der eingebettete Eigenschaftsname.The embedded property name.
WerteValues Ein Array von Zeichenfolgenwerten.An array of string values. Jedes Array Element stellt ein einzelnes Eigenschaften Listenelement dar.Each array item represents a single property list item.

Achtung

Das vornehmen von Änderungen an der Standort Steuerungs Datei kann zu einem irreparablen Schaden für Ihre Configuration Manager Site führen.Making changes to the site control file can cause irreparable damage to your Configuration Manager site.

So lesen Sie eine eingebettete Eigenschaften Liste für eine Standort Steuerungs DateiTo read a site control file embedded property list

  1. Richten Sie eine Verbindung mit dem SMS-Anbieter ein.Set up a connection to the SMS Provider. Weitere Informationen finden Sie unter Grundlagen des SMS-Anbieters.For more information, see SMS Provider fundamentals.

  2. Verwenden Sie das Verbindungs Objekt aus Schritt 1, um eine Standort Steuerungs Datei-Ressource zu erhalten.Using the connection object from step one, get a site control file resource. Weitere Informationen finden Sie unter Informationen zur Configuration Manager Standort Steuerungs Datei.For more information, see About the Configuration Manager Site Control File.

  3. Die SMS_EmbeddedPropertyList für die erforderliche eingebettete Eigenschaften Liste erhalten.Get the SMS_EmbeddedPropertyList for the required embedded property list.

  4. Greifen Sie mithilfe des SMS_EmbeddedPropertyList Eigenschafts Arrays Objekt Werte auf die Eigenschaften Listen Werte zu.Access the property list values by using the SMS_EmbeddedPropertyList object Values property array.

BeispielExample

Die folgende Beispiel Methode füllt den angegebenen- values Parameter mit dem Values -Array der eingebetteten Eigenschaften Liste auf, die SMS_EmbeddedPropertyList durch den-Parameter identifiziert wird propertyListName .The following example method populates the supplied values parameter with the Values array of the embedded property list SMS_EmbeddedPropertyList identified by the propertyListName parameter. true Wenn die eingebettete Eigenschaften Liste gefunden wird, wird zurückgegeben. andernfalls false wird zurückgegeben.true is returned if the embedded property list is found; otherwise, false is returned.

Informationen zum Anzeigen von Code, der diese Funktionen aufruft, finden Sie unter Lesen und Schreiben in die Configuration Manager Standort Steuerungs Datei mithilfe von verwaltetem Code oder unter Lesen und Schreiben in die Configuration Manager Standort Steuerungs Datei mithilfe von WMI.To view code that calls these functions, see 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.

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration Manager-Codeausschnitten.For information about calling the sample code, see Calling Configuration Manager Code Snippets.


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 Beispiel Methode verfügt über die folgenden Parameter:The sample method has the following parameters:

ParameterParameter typeType BESCHREIBUNGDescription
Resource - Verwaltet: IResultObject- Managed: IResultObject
-VBScript: Swap-Objekt- VBScript: SWbemObject
Die Ressource der Standort Steuerungs Datei, die die eingebettete Eigenschaft enthält.The site control file resource that contains the embedded property.
propertyListName - Verwaltet: String- Managed: String
- VBScript: String- VBScript: String
Die eingebettete Eigenschaften Liste, die gelesen werden soll.The embedded property list to be read.
Values -Verwaltet: String Array- Managed: String array
-VBScript: String Array- VBScript: String array
Die SMS_EmbeddedProperty Klasse Values-Eigenschaft.The SMS_EmbeddedProperty class Values property. Ein Array von Zeichenfolgenwerten.An array of string values.

Kompilieren des CodesCompiling the Code

Im c#-Beispiel werden die folgenden Kompilierungs Anforderungen aufgeführt:The C# example has the following compilation requirements:

NamespacesNamespaces

SystemSystem

System.Collections.GenericSystem.Collections.Generic

System.CollectionsSystem.Collections

System.TextSystem.Text

Microsoft.ConfigurationManagement.ManagementProviderMicrosoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngineMicrosoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

AssemblyAssembly

microsoft.configurationmanagement.managementprovidermicrosoft.configurationmanagement.managementprovider

adminui.wqlqueryengineadminui.wqlqueryengine

Stabile ProgrammierungRobust Programming

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager-Fehlern.For more information about error handling, see About Configuration Manager Errors.

.NET Framework-Sicherheit.NET Framework Security

Weitere Informationen zum Sichern von Configuration Manager Anwendungen finden Sie unter Configuration Manager rollenbasierte Verwaltung.For more information about securing Configuration Manager applications, see Configuration Manager role-based administration.

Weitere InformationenSee Also

Informationen zur Configuration Manager-StandortsteuerungsdateiAbout the Configuration Manager Site Control File
Lesen und Schreiben in die Configuration Manager Standort Steuerungs Datei mithilfe von verwaltetem Code How to Read and Write to the Configuration Manager Site Control File by Using Managed Code
Lesen und Schreiben in die Configuration Manager Standort Steuerungs Datei mithilfe von WMIHow to Read and Write to the Configuration Manager Site Control File by Using WMI