Een lijst met ingesloten eigenschappen van Configuration Manager sitebeheerbestand lezen

Artikel
04/04/2023

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

Een verbinding met de SMS-provider instellen. Zie Basisprincipes van SMS-provider voor meer informatie.
Haal met behulp van het verbindingsobject uit stap één een sitebeheerbestandsresource op. Zie Over het Configuration Manager sitebeheerbestand voor meer informatie.
Haal de SMS_EmbeddedPropertyList op voor de vereiste lijst met ingesloten eigenschappen.
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 How to Read and Write to the Configuration Manager Site Control File by Using WMI (Lezen en schrijven naar het Configuration Manager sitebeheerbestand met behulp van WMI).

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 sitebeheerbestand
Het Configuration Manager sitebeheerbestand lezen en schrijven met behulp van beheerde code
Lezen en schrijven naar het Configuration Manager sitebeheerbestand met behulp van WMI

Delen via