Propriété SWbemSecurity.Privileges

Article
07/03/2023

La propriété Privileges est un objet SWbemPrivilegeSet. Cette propriété est utilisée pour activer ou désactiver des privilèges Windows spécifiques. Vous devrez peut-être définir l’un de ces privilèges pour effectuer des tâches spécifiques à l’aide de l’API WMI (Windows Management Instrumentation).

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.

Cette propriété est en lecture seule.

Syntaxe

SWbemSecurity.Privileges As Object

Valeur de la propriété

Notes

Ce paramètre vous permet d’accorder ou de révoquer des privilèges dans le cadre d’une chaîne de moniker WMI. Pour obtenir la liste complète des valeurs applicables, consultez WbemPrivilegeEnum et Privilege Constants.

Vous pouvez modifier les privilèges définis pour les objets SWbemServices, SWbemObject, SWbemObjectSet, SWbemObjectPath et SwbemLocator en ajoutant des objets SWbemPrivilege à la propriété Privileges.

Il existe des différences fondamentales dans la façon dont les différentes versions de Windows gèrent les modifications apportées aux privilèges. Si vous développez une application qui est utilisée uniquement sur des plateformes Windows, vous pouvez définir ou révoquer des privilèges à tout moment.

L’exemple suivant définit seDebugPrivilege sur la connexion de moniker initiale pour obtenir un objet SWbemServices.

Set Service = GetObject( _
    "winmgmts:{impersonationLevel=impersonate, (Debug)}")

Pour plus d’informations sur la mise en forme de la chaîne de sécurité d’une connexion de moniker, consultez Privilege Constants.

L’exemple suivant effectue la même tâche, mais il définit le privilège après la connexion initiale à WMI.

Set Service = GetObject( _
    "winmgmts:{impersonationLevel=impersonate}")
Service.Security_.Privileges.AddAsString "SeDebugPrivilege", True

Notez que, pour les appels à SwbemPrivilegeSet.AddAsString, vous devez utiliser le nom complet du privilège de sécurité, par exemple « SeDebugPrivilege » au lieu de « Debug ».

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSecurity
IID	IID_ISWbemSecurity

Voir aussi

SWbemSecurity
Exécution d’opérations privilégiées
SWbemPrivilegeSet

Partager via