Principes de base du fournisseur de Configuration Manager WMI
Les applications et scripts basés sur un hôte de script Windows fonctionnent dans WMI (Windows Management Instrumentation) via le modèle objet WMI, qui définit l’interface de programmation pour WMI. Un certain nombre de types d’objets WMI sont utilisés lors de la manipulation d’objets Configuration Manager. Pour plus d’informations sur le modèle objet WMI, consultez Windows Management Instrumentation.
Dans les scripts Configuration Manager simples, vous utilisez les types d’objets WMI suivants :
SWbemLocator
SWbemServices
SWbemObjectSet
SWbemObject
Remarque
La compréhension des requêtes WQL (WMI Query Language) est très importante pour identifier les Configuration Manager objets que vous souhaitez lire. Les instructions WQL vous permettent de récupérer des objets Configuration Manager basés sur des requêtes de type SQL. Par exemple, l’instruction WQL suivante est utilisée pour identifier tous les systèmes Windows Server 2003 :
SELECT * FROM SMS_FullCollectionMembership WHERE CollectionID='SMS000FS'
Pour plus d’informations sur l’utilisation de VBScript et WMI, consultez Vue d’ensemble des objets.
SWbemLocator
L’objet SWbemServicesest utilisé pour créer une connexion authentifiée au fournisseur SMS. Vous utilisez la méthode ConnectServer pour établir la connexion au fournisseur SMS. Cette méthode est particulièrement utile si vous devez passer les informations d’identification de l’utilisateur à un serveur Configuration Manager distant pendant la connexion. Vous pouvez également utiliser la méthode GetObject de l’hôte de script Windows pour créer une connexion authentifiée. Le type d’objet retourné par GetObject
dépend des paramètres qui lui sont passés. Consultez How to Connect to a Configuration Manager Provider Using Managed Code et How to Connect to a Configuration Manager Provider Using WMI pour obtenir des exemples qui montrent comment utiliser SWbemLocator
ou GetObject
dans votre script de connexion.
SWbemServices
L’objet SWbemServices représente une connexion authentifiée à un fournisseur SMS, et il s’agit de l’objet que vous utilisez pour récupérer Configuration Manager objets. Vous recevez un SWbemServices
objet comme valeur de retour de la SWbemLocator
fonction ConnectServer
ou, sinon, comme valeur de retour lorsque la GetObject
méthode est utilisée pour se connecter au fournisseur SMS.
SWbemServices
a plusieurs méthodes, mais vous utilisez uniquement les méthodes Get, ExecQuery et InstancesOf pour récupérer des objets.
Get
retourne une instance unique d’un objet Configuration Manager (SWbemObject
).
ExecQuery
et InstancesOf
retournent Configuration Manager objets dans une collection (SWbemObjectSet
) d’objets Configuration Manager.
SWbemObjectSet
L’objet SWbemObjectSet représente une collection d’objets Configuration Manager. Vous pouvez l’utiliser pour énumérer dans la collection et lire des instances individuelles de l’objet Configuration Manager (SWbemObject
) qui vous intéresse. Vous obtenez généralement un SWbemObjectSet
objet qui vous est retourné à partir des SWbemServices
fonctions de récupération.
SWbemObject
L’objet SWbemObject vous permet d’accéder aux propriétés et autres informations d’un objet Configuration Manager.