qualificateurs de contexte Configuration Manager

Article
04/04/2023

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 managées, vous utilisez la propriété ConnectionManagerBase.Context pour spécifier des qualificateurs de contexte. Pour plus d’informations, consultez Ajout d’un qualificateur de contexte Configuration Manager à l’aide de code managé.

VBScript

Lorsque vous utilisez VBScript, vous utilisez l’ensemble d’interface SWBemNamedValue pour spécifier des qualificateurs de contexte en tant que 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, sont utilisés uniquement avec des zones fonctionnelles spécifiques du fournisseur SMS; mais LocaleID, MachineNameet ApplicationName sont destinés à votre application.

Qualificateur de contexte	Description
`ApplicationName`	Identifie l’application qui a effectué l’appel.
`ContextHandle`	Identifie l’emplacement où le fournisseur SMS a stocké vos qualificateurs de contexte mis en cache.
`InstanceCount`	Limite le nombre d’instances retournées par ExecQuery et CreateInstanceEnum.
`LimitToCollectionIDs`	Limite les résultats d’une requête de ressource aux membres des collections nommées.
`LocaleID`	Identifie la page de codes à utiliser.
`MachineName`	Identifie l’ordinateur qui exécute l’application.
`QueryQualifiers`	Retourne les indicateurs de bits SecurityVerbs lorsque vous exécutez des requêtes sur des objets sécurisés.
`SessionHandle`	Identifie la copie du fichier de contrôle de site de votre application à Configuration Manager.

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 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 Unknown est utilisée. Vous devez fournir la ApplicationName valeur lorsque vous appelez l’une des méthodes de message d’état d’augmentation, telles que SMS_StatusMessage::RaiseErrorStatusMsg, sinon l’appel échoue.

ContextHandle

Le ContextHandle qualificateur de contexte est une valeur de chaîne qui identifie l’emplacement où le fournisseur SMS a stocké vos qualificateurs de contexte mis en cache. Le fournisseur SMS géré gère le transfert de 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.

Créez un jeu de valeurs SWBemNamedValue .
Ajoutez vos qualificateurs à l’objet de contexte. Pour plus d’informations, consultez Comment ajouter un qualificateur de contexte Configuration Manager à l’aide de WMI.
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 passez en tant que paramètre de ExecMethod lorsque vous appelez GetContextHandle.
Supprimez tous les qualificateurs de votre objet de contexte.
Ajoutez le ContextHandle qualificateur et la valeur à votre objet de contexte.
Passez 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 différentes pour votre application.

Remarque

Après avoir mis en cache vos qualificateurs de contexte, vous pouvez remplacer vos valeurs mises en cache en ajoutant les mêmes qualificateurs de contexte, avec des valeurs différentes, à votre objet de contexte.

InstanceCount

Le InstanceCount qualificateur de contexte est une valeur entière utilisée pour limiter le nombre d’instances retournées par les méthodes ExecQuery et CreateInstanceEnum . Vous définissez InstanceCount la valeur égale au nombre maximal d’instances que vous souhaitez retourner à partir de la requête ou de l’énumérateur. Par exemple, la définition de la valeur InstanceCount 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. Actuellement, vous ne pouvez spécifier qu’une CollectionID seule valeur. Vous utilisez ce qualificateur pour 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 SMS_Group.

L’utilisateur doit disposer d’autorisations de ressource de lecture d’instance pour la collection à laquelle la ressource appartient. Vous devez utiliser la limitation des regroupements lorsque l’utilisateur ne dispose pas de droits de ressource de lecture de classe pour les collections ; sinon, aucune donnée n’est retournée. Pour SMS 2.0 avec Service Pack 1 et versions ultérieures, cette restriction s’applique uniquement 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 sous la forme MS\x, où x est l’ID des 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 la liste des ID de locale IDsparamètres régionaux attribués par Microsoft.

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.

Machinename

Le MachineName qualificateur de contexte est une valeur de chaîne qui identifie l’ordinateur qui exécute l’application. Vous devez 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 Unknown est utilisée. Vous devez fournir la valeur MachineName lorsque vous appelez l’une des méthodes de message d’état d’augmentation, telles que SMS_StatusMessage::RaiseRawStatusMsg, sinon l’appel échoue.

QueryQualifiers

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 QueryQualifiers de lors de l’interrogation 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 true sur si vous souhaitez que les indicateurs soient retournés. Ne pas créer QueryQualifiers est identique à définir sa valeur sur false.

SessionHandle

Le SessionHandle qualificateur de contexte est une valeur de chaîne qui est retourné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 à 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, qui n’a aucune protection contre les applications qui remplacent les données de l’autre.