Een lijst met ingesloten eigenschappen van Configuration Manager sitebeheerbestand lezen

In Configuration Manager leest u een lijst met ingesloten eigenschappen van een sitebeheerbestandsresource door het SMS_EmbeddedPropertyList-object voor het ingesloten object op te halen uit de eigenschappenmatrix proplists van resources.

Een lijst met ingesloten eigenschappen bevat de volgende eigenschappen die u kunt instellen. Zie SMS_EmbeddedPropertyList voor meer informatie.

Waarde	Beschrijving
PropertyListName	De naam van de ingesloten eigenschap.
Waarden	Een matrix met tekenreekswaarden. Elk matrixitem vertegenwoordigt één eigenschappenlijstitem.

Voorzichtigheid

Het aanbrengen van wijzigingen in het sitebeheerbestand kan onherstelbare schade aan uw Configuration Manager site veroorzaken.

Een lijst met ingesloten eigenschappen van een sitebeheerbestand lezen

1. Een verbinding met de SMS-provider instellen. Zie Basisprincipes van SMS-provider voor meer informatie.

2. Haal met behulp van het verbindingsobject uit stap één een sitebeheerbestandsresource op. Zie Over het Configuration Manager sitebeheerbestand voor meer informatie.

3. Haal de SMS_EmbeddedPropertyList op voor de vereiste lijst met ingesloten eigenschappen.

4. Open de waarden van de eigenschappenlijst met behulp van de eigenschap matrix Waarden van het SMS_EmbeddedPropertyList object.

Voorbeeld

Met de volgende voorbeeldmethode wordt de opgegeven values parameter gevuld met de matrix Values van de lijst SMS_EmbeddedPropertyList met ingesloten eigenschappen die wordt geïdentificeerd door de propertyListName parameter. true wordt geretourneerd als de lijst met ingesloten eigenschappen wordt gevonden; false anders wordt geretourneerd.

Zie How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Lezen en schrijven naar het Configuration Manager sitebeheerbestand met behulp van beheerde code) of Lees en schrijf naar het Configuration Manager Site-besturingselementbestand met behulp van WMI om code weer te geven die deze functies aanroept.

Zie Aanroepen Configuration Manager codefragmenten voor meer informatie over het aanroepen van de voorbeeldcode.

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;

}

De voorbeeldmethode heeft de volgende parameters:

Parameter	Type	Beschrijving
Resource	-Beheerd: IResultObject - VBScript: SWbemObject	De sitebeheerbestandsresource die de ingesloten eigenschap bevat.
propertyListName	-Beheerd: String - VBScript: String	De lijst met ingesloten eigenschappen die moet worden gelezen.
Values	- Beheerd: String matrix - VBScript: String matrix	De SMS_EmbeddedProperty eigenschap klassewaarden. Een matrix met tekenreekswaarden.

De code compileren

Het C#-voorbeeld heeft de volgende compilatievereisten:

Naamruimten

Systeem

System.Collections.Generic

System.Collections

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Vergadering

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robuust programmeren

Zie Over Configuration Manager fouten voor meer informatie over foutafhandeling.

.NET Framework Beveiliging

Zie Configuration Manager op rollen gebaseerd beheer voor meer informatie over het beveiligen van Configuration Manager toepassingen.

Zie ook

Over het Configuration Manager sitebeheerbestandLezen en schrijven naar het Configuration Manager sitebeheerbestand met behulp van beheerde codeHet Configuration Manager sitebeheerbestand lezen en schrijven met behulp van WMI