Guide pratique pour ajouter un qualificateur de contexte Configuration Manager à l’aide de code managé

Article
04/04/2023

Dans Configuration Manager, pour ajouter un qualificateur de contexte à l’aide du fournisseur SMS managé, utilisez la propriété Context qui est un Dictionary objet qui contient des qualificateurs de contexte.

En règle générale, vous ajoutez le nom de votre application au qualificateur de contexte ApplicationName, ainsi que le nom de l’ordinateur (MachineName) et l’identificateur de paramètres régionaux (LocaleID).

Pour ajouter Configuration Manager qualificateur de contexte

Configurez une connexion au fournisseur SMS. Pour plus d’informations, consultez Guide pratique pour se connecter à un fournisseur SMS dans Configuration Manager à l’aide de code managé
Obtenez l’objet SmsNamedValuesDictionary à partir de l’objet WqlConnectionManager que vous obtenez à l’étape 1.
Ajoutez les qualificateurs de contexte en fonction des besoins.

Exemple

L’exemple C# suivant ajoute d’abord un certain nombre de qualificateurs de contexte à une propriété de dictionnaire context de l’objet WQLConnectionManager. Il affiche ensuite une liste des qualificateurs de contexte dans l’objet dictionnaire.

Remarque

WqlConnectionManager dérive de ConnectionManagerBase.

Dans l’exemple, le LocaleID qualificateur de contexte est codé en dur en anglais (États-Unis). Si vous avez besoin des paramètres régionaux pour les non-États-Unis vous pouvez l’obtenir à partir de la propriété classe LocaleIDWMI du serveur SMS_Identification.

Pour plus d’informations sur l’appel de l’exemple de code, consultez Appel d’extraits de code Configuration Manager.

public void AddContextQualifiers(WqlConnectionManager connection)  
{  
    try  
    {  
        connection.Context.Add("ApplicationName", "My application name");  
        connection.Context.Add("MachineName","Computername");  
        connection.Context.Add("LocaleID", @"MS\1033");  

        foreach (KeyValuePair<string, object> namedValue in connection.Context)  
        {  
            Console.WriteLine(namedValue.Key);  
            Console.WriteLine(namedValue.Value);  
            Console.WriteLine();  
        }  
    }  
    catch (SmsException e)  
    {  
        Console.WriteLine("Failed to add context qualifier : " + e.Message);  
    }  
}

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

Paramètre	Type	Description
`connection`	- WqlConnectionManager	Connexion valide au fournisseur SMS.

Compilation du code

Espaces de noms

Système

System.Collections.Generic

System.ComponentModel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programmation robuste

Les exceptions Configuration Manager qui peuvent être levées sont SmsConnectionException et SmsQueryException. Ceux-ci peuvent être regroupés avec SmsException.

Voir aussi

qualificateurs de contexte Configuration Manager
Comment se connecter à un fournisseur Configuration Manager à l’aide de code managé

Partage via