Accès à une collection WMI
Une collection est un concept d’automatisation standard qui fournit une interface uniforme à un ensemble d’objets sur lesquels vous pouvez effectuer une itération. L’API Scripting pour WMI expose un certain nombre d’interfaces conformes au paradigme de collection. Dans chaque cas, utilisez la méthode Item pour identifier les éléments à l’aide d’une chaîne contenant la valeur.
Les collections SWbemPropertySet, SWbemQualifierSet et SWbemMethodSet sont principalement utilisées pour modifier le schéma. Un objet SWbemObjectSet contient des objets WMI, tels qu’une instance Win32_LogicalDisk, qui ont été obtenus via des appels, tels que SWbemServices.InstancesOf ou SWbemObject.Associators_. L’objet SWbemRefresher ne peut contenir que des instances de classes WMI. L’objet SWbemNamedValueSet peut contenir des objets WMI ou tout autre type de données requis par un fournisseur pour l’appel de méthode.
Notes
Les rubriques suivantes ont été écrites principalement pour VBScript. C# utilise l’interface IEnumerable standard pour rassembler et énumérer des objets. En revanche, PowerShell utilise généralement une collection d’objets implicite chaque fois qu’une valeur de retour contient plusieurs résultats.
Le tableau suivant répertorie les collections dans l’API Scripting pour WMI, ainsi que les éléments et paramètres de chaque collection.
Collection | Élément | Paramètre Item() |
---|---|---|
SWbemObjectSet | SWbemObject | Chemin d’accès de l’objet |
SWbemPropertySet | SWbemProperty | Nom de la propriété |
SWbemQualifierSet | SWbemQualifier | Nom du qualificateur |
SWbemMethodSet | SWbemMethod | Nom de la méthode |
SWbemNamedValueSet | SWbemNamedValue | Nom de la valeur |
SWbemPrivilegeSet | SWbemPrivilege | Nom du privilège |
SWbemRefresher | SWbemRefreshableItem | Index de l’élément dans l’objet SWbemRefresher |
Pour plus d’informations et des exemples d’ajout et de suppression d’éléments d’une collection, consultez Suppression d’un élément unique d’une collection et Suppression de plusieurs éléments d’une collection. Pour plus d’informations sur les classes, consultez Manipulation des informations sur les classes et instances.