Qualificateurs de contexte Configuration Manager

Les objets de contexte sont utilisés, dans Configuration Manager, pour fournir des informations supplémentaires au fournisseur SMS. En règle générale, vous utilisez des qualificateurs de contexte pour fournir au fournisseur SMS des informations contextuelles, telles que le nom de votre application. Vous pouvez utiliser des qualificateurs de contexte lorsque vous vous connectez au fournisseur SMS et avec des objets fournisseur SMS individuels.

Code managé

Lorsque vous utilisez les bibliothèques de fournisseur SMS gérées, vous utilisez la propriété ConnectionManagerBase.Context pour spécifier des délimiteurs de contexte. Pour plus d’informations, consultez Comment ajouter un qualificateur de contexte Configuration Manager à l’aide de code managé.

VBScript

Lorsque vous utilisez VBScript, vous utilisez l’interface SWBemNamedValue définie pour spécifier des qualificateurs de contexte sous la forme d’une collection d’objets de valeur nommés. Pour plus d’informations, consultez Comment ajouter un qualificateur de contexte Configuration Manager à l’aide de WMI.

Qualificateurs de contexte

Le tableau suivant contient les qualificateurs de contexte (valeurs nommées) utilisés par le fournisseur SMS. La plupart des qualificateurs, comme SessionHandle, ne sont utilisés qu’avec des zones fonctionnelles spécifiques du fournisseur de SMS, mais LocaleID, MachineNameet ApplicationName sont destinés à l’utilisation de votre application.

ApplicationName

Le ApplicationName qualificateur de contexte est une valeur de chaîne qui identifie le nom de l’application qui a effectué l’appel. Vous devez le spécifier ApplicationName pour votre application car elle est utilisée pour l’audit. Si vous ne fournissez pas le nom de votre application, la valeur Inconnu est utilisée. Vous devez fournir la ApplicationName valeur lorsque vous appelez l’une des méthodes de status de message de levée, telles que SMS_StatusMessage ::RaiseErrorStatusMsg, sinon l’appel échouera.

ContextHandle (en anglais)

Le ContextHandle délimiteur de contexte est une valeur de chaîne qui identifie l’emplacement où le fournisseur SMS a stocké vos délimiteurs de contexte mis en cache. Le fournisseur SMS géré gère le transfert des données. Lorsque vous utilisez VBScript, vous pouvez suivre les étapes suivantes pour réduire la quantité de données transmises sur le réseau.

1. Créer un ensemble de valeurs SWBemNamedValue .

2. Ajoutez vos qualificateurs à l’objet de contexte. Pour plus d’informations, consultez Comment ajouter un qualificateur de contexte Configuration Manager à l’aide de WMI.

3. Appelez la méthode GetContextHandle pour mettre en cache vos qualificateurs sur le serveur. Le fournisseur SMS met en cache l’objet de contexte que vous transmettez en tant que paramètre d’ExecMethod lorsque vous appelez GetContextHandle.

4. Supprimez tous les qualificateurs de votre objet de contexte.

5. Ajoutez le qualificateur et la ContextHandle valeur à votre objet de contexte.

6. Transmettez l’objet de contexte sur tous les appels à IWbemServices.

   Vous devez appeler la méthode ClearContextHandle pour supprimer vos qualificateurs mis en cache avant de quitter votre application. Vous pouvez créer autant de ContextHandle valeurs que vous le souhaitez, chacune fournissant des informations variables pour votre application.

Nombre d’instances

Le InstanceCount qualificateur de contexte est une valeur entière utilisée pour limiter le nombre d’instances renvoyées par les méthodes ExecQuery et CreateInstanceEnum . Vous définissez InstanceCount un nombre égal au nombre maximal d’instances que vous souhaitez retourner à partir de la requête ou de l’énumérateur. Par exemple, la définition InstanceCount sur 10 renvoie au maximum 10 instances.

LimitToCollectionIDs

Le LimitToCollectionIDs qualificateur de contexte est un tableau de chaînes qui contient une liste de CollectionID valeurs. Pour le moment, vous ne pouvez spécifier qu’une CollectionID seule valeur. Ce qualificateur permet de limiter les résultats d’une requête de ressource aux membres de la collection nommée. Une requête de ressource est une requête qui inclut des classes dérivées de SMS_Resource ou de SMS_Group.

L’utilisateur doit disposer des autorisations d’instance de lecture des ressources pour la collection à laquelle la ressource appartient. Vous devez utiliser la limitation de collecte lorsque l’utilisateur ne dispose pas des droits de ressource de lecture de classe pour les collections. sinon, aucune donnée n’est renvoyée. Pour SMS 2.0 avec Service Pack 1 et versions ultérieures, cette restriction ne s’applique qu’aux classes dérivées de SMS_Group.

Vous ne pouvez pas utiliser ce qualificateur lors de l’interrogation de collections.

LocaleID

Le LocaleID qualificateur de contexte est une valeur de chaîne qui accepte une valeur hexadécimale ou une valeur décimale au format MS\x, où x correspond à l’ID de paramètres régionaux. Par exemple, vous pouvez entrer la valeur anglaise LocaleID sous la forme ms\0x0409 ou ms\1033. Le fournisseur SMS accepte LocaleID uniquement les valeurs qui utilisent le format Microsoft. Vous trouverez une liste des ID de locale IDsparamètres régionaux At attribués par Microsoft.

Si vous avez besoin des paramètres régionaux pour les destinations hors États-Unis. installations, vous pouvez l’obtenir à partir de la propriété de classeLocaleID WMI SMS_Identification Server.

MachineName

Le MachineName qualificateur de contexte est une valeur de chaîne qui identifie l’ordinateur qui exécute l’application. Vous devez le spécifier MachineName pour votre application car elle est utilisée pour l’audit. Si vous ne fournissez pas le nom de l’ordinateur, la valeur Inconnu est utilisée. Vous devez fournir la valeur MachineName lorsque vous appelez l’une des méthodes de status de message de levée, telles que SMS_StatusMessage ::RaiseRawStatusMsg, sinon l’appel échouera.

Qualificateurs de requête

Le QueryQualifiers qualificateur de contexte est une valeur booléenne utilisée pour renvoyer les indicateurs de bits SecurityVerbs lorsque vous exécutez des requêtes sur des objets sécurisés, tels que SMS_Site ou SMS_Package. Notez que l’utilisation lors de l’interrogation QueryQualifiers d’objets non sécurisés génère une erreur. Par défaut, les indicateurs SecurityVerbs ne sont pas retournés avec la requête. Vous devez créer ce qualificateur et définir sa valeur sur true si vous souhaitez que les indicateurs soient renvoyés. Ne pas créer QueryQualifiers équivaut à définir sa valeur sur false.

Descripteur de session

Le SessionHandle qualificateur de contexte est une valeur de chaîne qui est renvoyée en tant que paramètre out de la méthode GetSessionHandle. La chaîne est un GUID unique qui identifie la copie du fichier de contrôle de site de votre application dans Configuration Manager. Vous devez utiliser ce mécanisme pour modifier le fichier de contrôle de site et réduire les collisions de données avec d’autres applications qui modifient le fichier de contrôle de site en même temps. Si vous ne fournissez pas de SessionHandle valeur, votre application modifie la copie globale du fichier de contrôle de site, laquelle n’est pas protégée contre le remplacement des données des applications entre elles.

Voir aussi

Procédure pour ajouter un délimiteur de contexte Configuration Manager à l’aide de code managéComment ajouter un délimiteur de contexte Configuration Manager à l’aidedes principes de base du fournisseur WMI SMS