Comment ajouter un qualificateur de contexte Configuration Manager à l’aide de WMI

Article
04/04/2023

Dans Configuration Manager, vous ajoutez des qualificateurs de contexte à une connexion (SWbemServices) ou à un objet (SWbemObject) en créant une valeur SWbemNamedValueSet définie pour contenir les qualificateurs de contexte. Vous fournissez ensuite la valeur SWbemNamedValueSet définie en tant que paramètre pour les méthodes de connexion et d’objet.

dans Configuration Manager, vous pouvez fournir le nom de votre application (ApplicationName), le nom de l’ordinateur (MachineName) et l’identificateur de paramètres régionaux (LocaleID).

Dans la plupart des cas, les qualificateurs de contexte ne sont pas nécessaires. La principale exception consiste à accéder au fichier de contrôle de site où ils sont nécessaires pour configurer les informations de session. Pour plus d’informations, consultez À propos du fichier de contrôle de site Configuration Manager.

Pour ajouter un qualificateur de contexte Configuration Manager

Configurez une connexion au fournisseur SMS. Pour plus d’informations, consultez Notions de base du fournisseur SMS.
Créez un objet WbemScripting.SWbemNamedValueSet et ajoutez les qualificateurs de contexte souhaités.
Utilisez le jeu de valeurs SWbemNamedValue que vous avez créé à l’étape 2 pour passer des qualificateurs de contexte aux appels de connexion et de manipulation d’objet.

Exemple

L’exemple VBScript suivant crée un jeu de valeurs SWbemNamedValueSet et ajoute les qualificateurs de contexte fournis. L’exemple de code suivant montre comment appeler la méthode pour une utilisation dans un appel de méthode Putd’objet de package SMS_Package. Pour plus d’informations sur les objets Configuration Manager, consultez Vue d’ensemble des objets.

Dim context

Set context = CreateContextQualifiers("My application" , "My Computer" , "MS\1033")

package.Put_ , context

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


Function CreateContextQualifiers(applicationName, machineName, localeID)  
    On Error Resume next  
    Dim smsContext  

    set smsContext = CreateObject("WbemScripting.SWbemNamedValueSet")  

    ' Add the context qualifiers to the set.  
    smsContext.Add "LocaleID", localeID  
    smsContext.Add "MachineName", machineName  
    smsContext.Add "ApplicationName", applicationName  

    Set CreateContextQualifiers = smsContext  

      If Err.Number<>0 Then  
        WScript.Echo Err.Description  
        CreateContextQualifiers = null  
        Exit Function  
    End If  
End Function

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

Paramètre	Type	Description
`applicationName`	- `String`	Qualificateur de contexte ApplicationName.
`machineName`	- `String`	Qualificateur de nom d’ordinateur.
`localeID`	- `String`	Identificateur des paramètres régionaux. Par exemple, MS\1033 est 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 `LocaleID`WMI du serveur SMS_Identification.

Compilation du code

Cet exemple VBScript nécessite :

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
Vue d’ensemble des objets Configuration Manager qualificateurs de contexte
Comment se connecter à un fournisseur SMS dans Configuration Manager à l’aide de WMI
Windows Infrastructure de gestion