Qualificateurs standards

Toutes les implémentations conformes à CIM doivent gérer un ensemble standard de qualificateurs. Un objet spécifique ne possède pas tous les qualificatifs énumérés. En règle générale, les classes d’extension fournissent des qualificateurs supplémentaires pour faciliter l’approvisionnement d’instances de classe et d’autres opérations sur la classe.

Il incombe au fournisseur d’appliquer les qualificateurs. WMI n’applique pas de qualificateurs, mais les utilise uniquement pour informer l’utilisateur de la façon dont la propriété est utilisée.

Notes

WMI est conforme à la spécification CIM 2.5.

Les tables présentent les limitations suivantes :

• Tous les qualificateurs standards ne peuvent pas être utilisés ensemble.
• Tous les qualificateurs ne peuvent pas être appliqués à toutes les constructions, telles que l’association ou la référence. Ces limitations sont identifiées dans la liste S’applique à.
• Pour une construction particulière, telle que l'association ou la référence, l'utilisation des qualificatifs légaux peut être encore plus limitée car certains s'excluent mutuellement, ou l'utilisation d'un qualificatif peut impliquer certaines restrictions sur la valeur d'un autre, et ainsi de suite. Ces règles d’utilisation sont documentées.
• Les qualificateurs juridiques sont hérités uniquement par des entités telles que des propriétés, des méthodes, des instances ou des sous-classes, et non par des associations ou des références. Par exemple, le qualificateur MaxLen qui s’applique aux propriétés n’est pas transmis aux références.

Voici la liste des qualificateurs standard WMI.

Abstract

Type de données : booléenne

S’applique à : classes, associations, indications

Indique si la classe est abstraite et sert uniquement de base pour les nouvelles classes. La valeur par défaut est FAUX. Vous ne pouvez pas créer d’instances de classes abstraites. L’absence de ce qualificateur indique que la classe n’est pas abstraite ; par conséquent, ce qualificateur est requis pour toutes les classes abstraites.

Aggregate

Type de données : booléenne

S'applique à : références

Indique si la référence est le composant parent d’une association d’agrégation. La valeur par défaut est FAUX.

Utilisation : les qualificateurs Aggregation et Aggregate sont utilisés ensemble. Aggregation qualifie l’association, et Aggregate spécifie la référence parente.

Aggregation

Type de données : booléenne

S’applique à : associations

Indique si l’association est une agrégation. La valeur par défaut est FAUX. Utilisé avec Agrégation. Ce qualificateur est requis pour toutes les associations d’agrégation.

Alias

Type de données : chaîne

S’applique à : propriétés, références, méthodes

Autre nom pour une propriété ou une méthode dans le schéma. La valeur par défaut est NULL.

ArrayType

Type de données : chaîne

S’applique à : propriétés, paramètres

Type du tableau qualifié.

Les valeurs autorisées sont :

• panier (par défaut)
• indexé
• ordered

Utilisation : appliquez ce type de qualificateur uniquement aux propriétés et paramètres qui sont des tableaux (définis à l’aide de la syntaxe entre crochets).

BitMap

Type de données : tableau de chaînes

S’applique à : propriétés, méthodes, paramètres

Carte des positions de bits significatives où chaque position significative peut être « on » ou « off ». Chaque bit « on » est mappé à une valeur correspondante dans le tableau BitValues . En ayant plusieurs bits « on », plusieurs valeurs sont simultanément indiquées dans le tableau BitValues. La valeur par défaut est NULL.

Pour plus d’informations, consultez BitMap et BitValues.

BitValues

Type de données : tableau de chaînes

S’applique à : propriétés, méthodes, paramètres

Traduction d’une valeur de position de bit dans une chaîne associée. La valeur par défaut est NULL.

Pour plus d’informations, consultez BitMap et BitValues.

Constructor

Type de données : booléenne

S’applique à : méthodes

Indique si la méthode crée des instances. Ces méthodes ne sont pas limitées à agir sur une seule instance ou une seule classe. Par exemple, un constructeur peut créer des instances d’association ainsi que des instances de la classe qui définit le constructeur.

Le qualificateur Constructor est uniquement destiné à des informations, et il n’est pas prévu qu’il soit activé par le gestionnaire d’objets. Le gestionnaire d’objets n’a pas besoin d’appeler des méthodes de constructeur lorsqu’un objet est créé. De plus, lorsqu’un constructeur est appelé, le gestionnaire d’objets n’a pas besoin d’appeler des méthodes de constructeur définies pour une classe parente de la classe d’origine. La valeur par défaut est FAUX.

CreateBy

Type de données : chaîne

S’applique à : classes

Nom de la méthode par laquelle les instances de cette classe sont créées. La valeur est « PutInstance » ou le nom d’une autre méthode créant des instances. La valeur par défaut est NULL.

Utilisation : ce qualificateur ne peut être utilisé que si le qualificateur SupportsCreate est présent.

DeleteBy

Type de données : chaîne

S’applique à : classes

Nom de la méthode par laquelle les instances de cette classe sont supprimées. La valeur est « DeleteInstance » ou le nom d’une autre méthode créant des instances. La valeur par défaut est NULL.

Utilisation : ce qualificateur ne peut être utilisé que si le qualificateur SupportsDelete est présent.

Description

Type de données : chaîne

S’applique à : tout

Description d’un élément nommé. La valeur par défaut est NULL.

Destructor

Type de données : booléenne

S’applique à : méthodes

Indique si la méthode supprime des instances. Les méthodes utilisant le qualificateur Destructor suppriment la ou les instances auxquelles le destructeur est appliqué et ne sont pas contraintes à agir sur une seule instance ou classe. Par exemple, un destructeur peut supprimer des instances d’association ainsi que des instances de la classe qui définit le destructeur.

Le qualificateur Destructor est uniquement destiné à des informations, et il n’est pas prévu qu’il soit activé par le gestionnaire d’objets. Le gestionnaire d’objets n’est pas obligé d’appeler une méthode ayant le qualificateur Destructor lorsqu’une instance est supprimée. De plus, lorsqu’un destructeur est appelé, le gestionnaire d’objets n’a pas besoin d’appeler des méthodes de destructeur définies pour une classe parente de la classe d’origine. La valeur par défaut est FAUX.

DisplayName

Type de données : chaîne

S’applique à : tout

Nom affiché dans l’IU au lieu du nom réel de l’élément. La valeur par défaut est NULL.

EmbeddedInstance

Type de données : chaîne

S’applique à : tout

L’élément de type chaîne qualifié contient une instance incorporée. La valeur du qualificateur spécifie le nom d’une classe CIM dans le même espace de noms que la classe propriétaire de l’élément qualifié. L’instance incorporée est une instance de la classe spécifiée, y compris les instances de ses sous-classes. La valeur par défaut est NULL.

Gauge

Type de données : booléenne

S’applique à : tout

Indique si la propriété représente un entier non négatif, qui peut augmenter ou diminuer, mais jamais dépasser une valeur maximale. La valeur par défaut est FAUX.

La valeur maximale de la propriété ne peut pas être supérieure à 2^n - 1. N peut être 8, 16, 32 ou 64 selon le type de données de la propriété à laquelle ce qualificateur est appliqué. La valeur d’une jauge a sa valeur maximale chaque fois que les informations modélisées sont supérieures ou égales à cette valeur maximale. Si les informations modélisées diminuent ultérieurement en dessous de la valeur maximale, la jauge diminue également. Ce qualificateur s’applique uniquement aux propriétés avec un type de données entier non signé.

In

Type de données : booléenne

S'applique à : paramètres

Indique si le paramètre est utilisé pour passer des valeurs à une méthode. La valeur par défaut est VRAI.

In, Out

Type de données : booléenne

S'applique à : paramètres

Indique que le paramètre représente à la fois un paramètre d’entrée et de sortie.

Key

Type de données : booléenne

S’applique à : propriétés, références

Indique si la propriété fait partie de la poignée d’espace de noms. Si plusieurs propriétés ont le qualificateur de Key, toutes ces propriétés forment collectivement la clé (une clé composée). Lorsqu’elles sont regroupées, les propriétés de clé doivent fournir une référence unique pour chaque instance de classe. Si ce qualificateur est placé sur une propriété, seule la valeur VRAI est autorisée.

Lazy

S’applique à : propriétés

Indique que la restitution du bien est coûteuse en ressources et nécessite beaucoup de temps processeur et de mémoire. WMI améliore les performances des requêtes en ne tentant pas de retourner les propriétés marquées avec le qualificateur lazy.

MappingStrings

Type de données : tableau de chaînes

S’applique à : classes, propriétés, associations, indications, références

Ensemble de valeurs qui indiquent un chemin d’accès à un emplacement où vous trouverez plus d’informations sur l’origine d’une propriété, d’une classe, d’une association, d’une indication ou d’une référence. La chaîne de mappage peut être un chemin de répertoire, une URL, une clé de registre, un fichier d'inclusion, une référence à une classe CIM ou un autre format. La valeur par défaut est NULL.

Max

Type de données : int

S'applique à : références

Nombre maximal de valeurs qu’une référence donnée peut avoir pour chaque ensemble d’autres valeurs de référence dans l’association. La valeur par défaut est NULL. Par exemple, si une association lie des instances A à des instances B et qu’il doit y avoir au maximum une instance A pour chaque instance B, la référence à A doit avoir un maximum de un qualificateur.

MaxLen

Type de données : int

S’applique à : propriétés, méthodes, paramètres

Longueur maximale (en caractères) d’un élément de données de chaîne, indique la prise en charge des tableaux de longueur fixe.

Si un tableau de longueur fixe est rencontré, le qualificateur MaxLen contient la longueur fixe trouvée lors de l’analyse. Si un tableau de longueur variable est rencontré, ce qualificateur n’est pas utilisé. MaxLen est utilisé pour suggérer le nombre maximal d’éléments qui doivent être stockés dans un tableau. Lors de la substitution de la valeur par défaut, toute valeur entière non signée (uint32) peut être spécifiée. Une valeur NULL (valeur par défaut) implique une longueur illimitée.

MaxValue

Type de données : int

S’applique à : propriétés, méthodes, paramètres

Valeur maximale de l’objet. La valeur par défaut est NULL.

Min

Type de données : int

S'applique à : références

Cardinalité minimale de la référence (nombre minimal de valeurs qu’une référence donnée peut avoir pour chaque ensemble d’autres valeurs de référence dans l’association). La valeur par défaut est 0.

Par exemple, si une association lie des instances A à des instances B et qu’il doit y avoir au moins une instance A pour chaque instance B, la référence à A doit avoir au moins un qualificateur.

MinValue

Type de données : int

S’applique à : propriétés, méthodes, paramètres

Indique la valeur minimale de l’objet. La valeur par défaut est NULL.

ModelCorrespondence

Type de données : tableau de chaînes

S’applique à : propriétés

Ensemble de valeurs qui indiquent la correspondance entre la propriété d’un objet et d’autres propriétés dans le schéma CIM. La valeur par défaut est NULL.

Les propriétés d’objet sont identifiées à l’aide de la syntaxe suivante.

<nom de> schéma « _ » <classe ou nom d’association> « . » <nom de la propriété>

Nonlocal

Type de données : chaîne

S'applique à : références

Emplacement d’un instance, dont la valeur est <namespacetype>://<namespacehandle> La valeur par défaut est NULL.

Utilisation : ce qualificateur ne peut pas être utilisé avec le qualificateur NonlocalType .

NonlocalType

Type de données : chaîne

S'applique à : références

Type d’emplacement d’une instance. Sa valeur est <namespacetype>. La valeur par défaut est NULL.

Utilisation : ce qualificateur ne peut pas être utilisé avec le qualificateur Nonlocal .

NullValue

Type de données : chaîne

S’applique à : propriétés

Valeur qui indique que la propriété associée est NULL (la propriété n’a pas de valeur valide ou significative). La valeur par défaut est NULL.

Les conventions et restrictions utilisées pour définir des valeurs NULL sont les mêmes que celles applicables au qualificateur ValueMap. Notez que ce qualificateur ne peut pas être remplacé. Il n’est pas raisonnable d’autoriser une sous-classe à retourner une valeur NULL différente de celle de la classe parente.

Sortie

Type de données : booléenne

S'applique à : paramètres

Indique si le paramètre retourne des valeurs à partir d’une méthode . La valeur par défaut est FAUX.

Override

Type de données : chaîne

S’applique à : propriétés, méthodes, références

Classe parente ou construction subordonnée (propriété, méthode ou référence) qui est remplacée par la propriété, la méthode ou la référence du même nom dans la classe dérivée. La valeur par défaut est NULL.

Le format est le suivant :

[<classe>.]<construction subordonnée>

Si le nom de la classe est omis, le remplacement s’applique à la construction subordonnée dans la classe parente dans la hiérarchie de classe.

Utilisation : le qualificateur Override peut faire référence à des constructions uniquement basées sur le même modèle méta. Il n’est pas autorisé à modifier un nom ou une signature de construction pendant une opération de remplacement.

OverrideValue

S’applique à : classes

Indique si la valeur de propriété d’une sous-classe remplace la valeur dans une classe parente. L’implication fonctionnelle est que, si vous effectuez une requête sur la classe parente et si votre clause OÙ inclut cette propriété, le parent doit retourner une instance avec la valeur remplacée. Par conséquent, Windows Management ajuste la clause OÙ de la requête envoyée à la classe parente pour exclure les références de cette propriété.

Propagated

Type de données : chaîne

S’applique à : propriétés

Nom de la clé propagée. La valeur par défaut est NULL.

L’utilisation de ce qualificateur suppose l’existence d’un seul qualificateur faible sur une référence dont la classe conteneur est la cible. La propriété associée doit avoir la même valeur que la propriété nommée par le qualificateur dans la classe de l’autre côté de l’association faible. Le format est le suivant :

[<classe>.]<construction subordonnée>

Utilisation : lorsque le qualificateur Propagated est utilisé, le qualificateur Key doit être spécifié avec la valeur VRAI.

Read

Type de données : booléenne

S’applique à : propriétés

Indique si la propriété est lisible. La valeur par défaut est VRAI.

Required

Type de données : booléenne

S’applique à : propriétés

Indique si une valeur non nulle est requise pour la propriété . La valeur par défaut est FAUX.

Revision

Type de données : chaîne

S’applique à : classes, associations, indications, schémas

Numéro de révision mineur de l’objet de schéma. La valeur par défaut est NULL.

Utilisation : le qualificateur Version doit être présent pour fournir le numéro de version principale lorsque le qualificateur Revision est utilisé.

Schema

Type de données : chaîne

S’applique à : propriétés, méthodes

Nom du schéma dans lequel une procédure stockée est définie. La valeur par défaut est NULL.

Source

Type de données : chaîne

S’applique à : classes, associations, indications, références

Emplacement d’une instance. La valeur par défaut est NULL.

La valeur du qualificateur est <namespacetype>://<namespacehandle>.

Utilisation : le qualificateur Source ne peut pas être utilisé avec le qualificateur SourceType .

SourceType

Type de données : chaîne

S’applique à : classes, associations, indications, références

Type d’emplacement d’une instance. La valeur de ce qualificateur est <namespacetype>. La valeur par défaut est NULL.

Utilisation : le qualificateur SourceType ne peut pas être utilisé avec le qualificateur Source.

SupportsCreate

Type de données : booléenne

S’applique à : classes

Indique si la classe prend en charge la création d’instances. La valeur par défaut est FAUX.

SupportsDelete

Type de données : booléenne

S’applique à : classes

Indique si la classe prend en charge la suppression d’instances. La valeur par défaut est FAUX.

SupportsUpdate

Type de données : booléenne

S’applique à : classes

Indique si la classe prend en charge la modification (mise à jour) des instances. La valeur par défaut est FAUX.

Terminal

Type de données : booléenne

S’applique à : classes

Indique si la classe peut avoir des sous-classes. La valeur par défaut est FAUX.

Si une sous-classe est déclarée, le compilateur génère une erreur.

Utilisation : ce qualificateur ne peut pas coexister avec le qualificateur Abstract . Si les qualificateurs Terminal et Abstract sont spécifiés, le compilateur génère une erreur.

Units

Type de données : chaîne

S’applique à : propriétés, méthodes, paramètres

Type d’unité dans laquelle est exprimé l’élément de données associé. La valeur par défaut est NULL.

Par exemple, un élément de données de taille peut avoir une valeur en « octets » pour Units.

ValueMap

Type de données : tableau de chaînes

S’applique à : propriétés, méthodes, paramètres

Ensemble de valeurs autorisées pour une propriété, un type de retour de méthode ou un paramètre de méthode. La valeur par défaut est NULL.

Utilisation : ce qualificateur peut être utilisé seul ou en combinaison avec le qualificateur Values . Lorsqu’il est utilisé en combinaison avec le qualificateur Values, l’emplacement de la valeur dans le tableau ValueMap fournit l’emplacement de l’entrée correspondante dans le tableau Valeurs . Utilisez le qualificateur ValueMap uniquement avec des valeurs de chaîne et d’entier. La syntaxe de la représentation d’une valeur entière dans le tableau de mappage de valeurs est [+|=]digit[*digit]. Le contenu, le nombre maximal de chiffres et la valeur représentée sont limités par le type de la propriété associée. Par exemple, uint8 ne peut pas être signé, doit être inférieur à quatre chiffres et doit représenter une valeur inférieure à 256.

Values

Type de données : tableau de chaînes

S’applique à : propriétés, méthodes, paramètres

Ensemble de valeurs qui traduisent une valeur entière en chaîne associée. La valeur par défaut est NULL.

Cette propriété spécifie également un tableau de valeurs de chaîne à mapper à une propriété d’énumération. Ce qualificateur peut être appliqué à une propriété entière ou à une propriété de chaîne, et le mappage peut être implicite ou explicite. Si la correspondance est implicite, les valeurs des propriétés de type entier ou chaîne représentent des positions ordinales dans le tableau Valeurs. Si le mappage est explicite, la propriété doit être un entier et les valeurs de propriété valides sont répertoriées dans le tableau défini par le qualificateur ValueMap . Pour plus d’informations, consultez Value Map.

Si aucun qualificateur ValueMap n’est présent, le tableau Valeurs est indexé (zéro relatif) à l’aide de la valeur dans la propriété, du type de retour de méthode ou du paramètre de méthode associé. Si un qualificateur ValueMap est présent, l’index de valeurs est défini par l’emplacement de la valeur de propriété dans le mappage de valeurs.

Version

Type de données : chaîne

S’applique à : classes, schémas, associations, indications

Numéro de version principale de l’objet de schéma. La valeur par défaut est NULL. Le numéro de version est incrémenté lorsque des changements sont apportés au schéma et en modifient l'interface.

Weak

Type de données : booléenne

S'applique à : références

Indique si les clés de la classe référencée incluent celles des autres participants de l’association. La valeur par défaut est FAUX.

Ce qualificateur est utilisé lorsque l’identité de la classe référencée dépend de celle des autres participants de l’association. Aucune référence à une classe donnée ne peut être faible. Les autres classes de l’association doivent définir une clé. Les clés des autres classes de l’association sont répétées dans la classe référencée et sont étiquetées avec un qualificateur Propagated.

Write

Type de données : booléenne

S’applique à : propriétés

Indique que les applications ou les scripts peuvent modifier la valeur de la propriété. Le compte qui exécute l’application doit avoir accès à l’espace de noms contenant des instances de la classe . L’implémentation du fournisseur peut également limiter l’accès aux données du fournisseur. La valeur VRAI indique que la propriété est lisible et accessible en écriture par les consommateurs autorisés par WMI et par le fournisseur. La valeur par défaut est FAUX.

Une propriété qui n’a pas le qualificateur Write peut toujours être accessible en écriture. L’implémentation du fournisseur peut autoriser la modification de toutes les propriétés des classes de fournisseur, que le qualificateur Write soit présent ou non.

WriteAtCreate

Type de données : booléenne

S’applique à : propriétés

Indique si la propriété est accessible en écriture lors de la création de l’instance. Ce qualificateur peut être utilisé conjointement avec le qualificateur WriteAtCreate . La valeur par défaut est FAUX.

WriteAtUpdate

Type de données : booléenne

S’applique à : propriétés

Indique si la propriété est accessible en écriture lors de la mise à jour de l’instance. Ce qualificateur peut être utilisé conjointement avec le qualificateur WriteAtCreate . La valeur par défaut est FAUX.

Exemples

Pour plus d’informations sur la récupération des qualificateurs, consultez l’exemple de code PowerShell Get-WmiClassMethodsAndWritableWmiProperties sur TechNet Gallery.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008

Voir aussi

Qualificateurs WMI

Ajout d’un qualificateur