Come leggere un elenco di proprietà incorporate di un file di controllo del sito Configuration Manager

Articolo
04/04/2023

In Configuration Manager si legge un elenco di proprietà incorporate da una risorsa file di controllo del sito recuperando l'oggetto SMS_EmbeddedPropertyList per l'oggetto incorporato dalla matrice di proprietà PropLists delle risorse.

Un elenco di proprietà incorporate include le proprietà seguenti che è possibile impostare. Per altre informazioni, vedere SMS_EmbeddedPropertyList.

Valore	Descrizione
PropertyListName	Nome della proprietà incorporata.
Valori	Matrice di valori stringa. Ogni elemento della matrice rappresenta un singolo elemento dell'elenco delle proprietà.

Attenzione

Apportare modifiche al file di controllo del sito può causare danni irreparabili al sito Configuration Manager.

Per leggere un elenco di proprietà incorporate di un file di controllo del sito

Configurare una connessione al provider SMS. Per altre informazioni, vedere Nozioni fondamentali sul provider SMS.
Usando l'oggetto connessione del passaggio 1, ottenere una risorsa file di controllo del sito. Per altre informazioni, vedere Informazioni sul file di controllo del sito Configuration Manager.
Ottenere l'oggetto SMS_EmbeddedPropertyList per l'elenco di proprietà incorporate richiesto.
Accedere ai valori dell'elenco di proprietà usando la matrice di proprietà Values dell'oggettoSMS_EmbeddedPropertyList.

Esempio

Il metodo di esempio seguente popola il parametro fornito values con la matrice Values dell'elenco SMS_EmbeddedPropertyList di proprietà incorporate identificato dal propertyListName parametro . true viene restituito se viene trovato l'elenco di proprietà incorporate; in caso contrario, false viene restituito.

Per visualizzare il codice che chiama queste funzioni, vedere How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Come leggere e scrivere nel file di controllo del sito Configuration Manager usando WMI).

Per informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice 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;  

}

Il metodo di esempio ha i parametri seguenti:

Parametro	Tipo	Descrizione
`Resource`	-Gestito: `IResultObject` - VBScript: SWbemObject	Risorsa file di controllo del sito che contiene la proprietà incorporata.
`propertyListName`	-Gestito: `String` -Vbscript: `String`	Elenco di proprietà incorporate da leggere.
`Values`	- Gestito: `String` matrice - VBScript: `String` matrice	Proprietà Values della `SMS_EmbeddedProperty` classe. Matrice di valori stringa.

Compilazione del codice

L'esempio C# presenta i requisiti di compilazione seguenti:

Namespaces

Sistema

System.collections.generic

System.Collections

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programmazione efficiente

Per altre informazioni sulla gestione degli errori, vedere Informazioni sugli errori di Configuration Manager.

Sicurezza di .NET Framework

Per altre informazioni sulla protezione delle applicazioni Configuration Manager, vedere Configuration Manager'amministrazione basata sui ruoli.

Vedere anche

Informazioni sul file di controllo del sito Configuration Manager
Come leggere e scrivere nel file di controllo del sito Configuration Manager usando codice gestito
Come leggere e scrivere nel file di controllo del sito Configuration Manager tramite WMI

Condividi tramite