Guide pratique pour lire une liste de propriétés incorporées d’un fichier de contrôle de site Configuration Manager

Article
04/04/2023

Dans Configuration Manager, vous lisez une liste de propriétés incorporée à partir d’une ressource de fichier de contrôle de site en obtenant l’objet SMS_EmbeddedPropertyList de l’objet incorporé à partir du tableau de propriétés PropLists de ressources.

Une liste de propriétés incorporées contient les propriétés suivantes que vous pouvez définir. Pour plus d’informations, consultez SMS_EmbeddedPropertyList.

Valeur	Description
PropertyListName	Nom de la propriété incorporée.
Valeurs	Tableau de valeurs de chaîne. Chaque élément de tableau représente un élément de liste de propriétés unique.

Attention

Apporter des modifications au fichier de contrôle de site peut causer des dommages irréparables à votre Configuration Manager site.

Pour lire une liste de propriétés incorporées de fichier de contrôle de site

Configurez une connexion au fournisseur SMS. Pour plus d’informations, consultez Notions de base du fournisseur SMS.
À l’aide de l’objet de connexion de l’étape 1, obtenez une ressource de fichier de contrôle de site. Pour plus d’informations, consultez À propos du fichier de contrôle de site Configuration Manager.
Obtenez le SMS_EmbeddedPropertyList pour la liste de propriétés incorporées requise.
Accédez aux valeurs de la liste de propriétés à l’aide du tableau de propriétés Valeurs de l’objetSMS_EmbeddedPropertyList.

Exemple

L’exemple de méthode suivant remplit le paramètre fourni values avec le tableau Valeurs de la liste SMS_EmbeddedPropertyList de propriétés incorporées identifiée par le propertyListName paramètre . true est retourné si la liste de propriétés incorporées est trouvée ; sinon, false est retourné.

Pour afficher le code qui appelle ces fonctions, consultez How to Read and Write to the Configuration Manager Site Control File by Using Managed Code ou How to Read and Write to the Configuration Manager Site Control File by Using WMI.

Pour plus d’informations sur l’appel de l’exemple de code, consultez Appel d’extraits de code 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;  

}

L’exemple de méthode a les paramètres suivants :

Paramètre	Type	Description
`Resource`	-Géré: `IResultObject` - VBScript : SWbemObject	Ressource de fichier de contrôle de site qui contient la propriété incorporée.
`propertyListName`	-Géré: `String` -Vbscript: `String`	Liste de propriétés incorporées à lire.
`Values`	- Géré : `String` tableau - VBScript : `String` tableau	Propriété `SMS_EmbeddedProperty` values de classe. Tableau de valeurs de chaîne.

Compilation du code

L’exemple C# présente les exigences de compilation suivantes :

Espaces de noms

Système

System.Collections.Generic

System.Collections

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programmation robuste

Pour plus d’informations sur la gestion des erreurs, consultez À propos des erreurs Configuration Manager.

Sécurité de .NET Framework

Pour plus d’informations sur la sécurisation des applications Configuration Manager, consultez Configuration Manager’administration basée sur les rôles.

Voir aussi

À propos du fichier de contrôle de site Configuration Manager
Guide pratique pour lire et écrire dans le fichier de contrôle de site Configuration Manager à l’aide de code managé
Guide pratique pour lire et écrire dans le fichier de contrôle de site Configuration Manager à l’aide de WMI

Partage via