Partager via


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

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

  1. Configurez une connexion au fournisseur SMS. Pour plus d’informations, consultez Notions de base du fournisseur SMS.

  2. À 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.

  3. Obtenez le SMS_EmbeddedPropertyList pour la liste de propriétés incorporées requise.

  4. 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