Comment lire une liste de propriétés incorporées du 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 des ressources de l’utilitaire PropList .

Une liste de propriétés incorporées possède 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înes. Chaque élément de tableau représente un élément de liste de propriétés unique.

Attention

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

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 principes de base du fournisseur SMS.

  2. À l’aide de l’objet de connexion de l’étape 1, obtenir 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. Obtient 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 en utilisant le SMS_EmbeddedPropertyList tableau de propriétés valeurs de l’objet.

Exemple

L’exemple de méthode suivant remplit le values paramètre fourni avec le tableau de valeurs de la liste de propriétés incorporées SMS_EmbeddedPropertyList identifié 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 Guide pratique pour lire et écrire dans le fichier de contrôle de site Configuration Manager à l’aide du code managé ou consultez lecture et écriture dans le fichier de contrôle de site Configuration Manager à l’aide de WMI.

Pour plus d’informations sur l’appel de l’exemple de code, consultez Calling Configuration Manager Code Snippets (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 possède 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
SMS_EmbeddedPropertyPropriété de valeurs de classe. Tableau de valeurs de chaînes.

Compilation du code

L’exemple C# présente les spécifications 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 fiable

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

Sécurité du .NET Framework

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

Voir aussi

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