Classe Win32_UserAccount
La classe Win32_UserAccountWMI contient des informations sur un compte d’utilisateur sur un système d’ordinateur exécutant Windows.
Remarque
Étant donné que le nom et le domaine sont des propriétés clés, l’énumération de Win32_UserAccount sur un réseau volumineux peut affecter négativement les performances. L’appel de GetObject ou l’interrogation d’une instance spécifique a moins d’impact.
La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés et les méthodes sont classées par ordre alphabétique, et non par ordre MOF.
Syntaxe
[Dynamic, Provider("CIMWin32"), UUID("{8502C4CC-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_UserAccount : Win32_Account
{
uint32 AccountType;
string Caption;
string Description;
boolean Disabled;
string Domain;
string FullName;
datetime InstallDate;
boolean LocalAccount;
boolean Lockout;
string Name;
boolean PasswordChangeable;
boolean PasswordExpires;
boolean PasswordRequired;
string SID;
uint8 SIDType;
string Status;
};
Membres
La classe Win32_UserAccount possède ces types de membres :
Méthodes
La classe Win32_UserAccount a ces méthodes.
| Méthode | Description |
|---|---|
| Renommer | Autorise le changement de nom du compte d’utilisateur. |
Propriétés
La classe Win32_UserAccount a ces propriétés.
-
AccountType
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API|Network Management Structures|USER_INFO_2|usri2_flags »)
Indicateurs qui décrivent les caractéristiques d’un compte d’utilisateur Windows.
-
-
Compte en double temporaire (256)
-
UF_TEMP_DUPLICATE_ACCOUNT
Compte d’utilisateur local pour les utilisateurs disposant d’un compte principal dans un autre domaine. Ce compte fournit l’accès utilisateur à ce domaine uniquement, et non à un domaine qui approuve ce domaine.
-
Compte normal (512)
-
UF_NORMAL_ACCOUNT
Type de compte par défaut qui représente un utilisateur classique.
-
Compte de confiance inter-domaines (2048)
-
UF_INTERDOMAIN_TRUST_ACCOUNT
Compte d’un domaine système qui approuve d’autres domaines.
-
Compte de confiance de station de travail (4096)
-
UF_WORKSTATION_TRUST_ACCOUNT
Compte d’ordinateur pour un système d’ordinateur exécutant Windows qui est membre de ce domaine.
-
Compte de confiance de serveur (8192)
-
UF_SERVER_TRUST_ACCOUNT
Compte d’un contrôleur de domaine de sauvegarde système qui est membre de ce domaine.
Caption
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64), DisplayName ("Légende")
Domaine et nom d’utilisateur du compte.
Cette propriété est héritée de CIM_ManagedSystemElement.
Description
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Description »)
Description du compte.
Cette propriété est héritée de CIM_ManagedSystemElement.
Disabled
-
Type de données : booléen
-
Type d’accès : lecture/écriture
-
Qualificateurs : MappingStrings (« Win32API|Network Management Structures|USER_INFO|UF_ACCOUNTDISABLE »)
Le compte d’utilisateur est désactivé.
Domaine
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Override (« Domain »), MappingStrings (« Win32API |Network Management Functions|domainname »)
Nom du domaine Windows auquel appartient un compte d’utilisateur, par exemple : « NA-SALES ».
FullName
-
Type de données : chaîne
-
Type d’accès : lecture/écriture
-
Qualificateurs : MappingStrings (« Win32API|Network Management Structures|USER_INFO_2||usri2_full_name »)
Nom complet d’un utilisateur local, par exemple : « Dan Wilson ».
InstallDate
-
Type de données : DateHeure
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Date d’installation")
Date d’installation de l’objet. Cette propriété n'a pas besoin de valeur pour indiquer que l'objet est installé.
Cette propriété est héritée de CIM_ManagedSystemElement.
LocalAccount
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : Fixed
Si la valeur est true, le compte est défini sur l’ordinateur local.
Cette propriété est héritée de Win32_Account.
Verrouillé
-
Type de données : booléen
-
Type d’accès : lecture/écriture
-
Qualificateurs : MappingStrings (« Win32API|Network Management Structures|USER_INFO_2||UF_LOCKOUT »)
Si la valeur est true, le compte d’utilisateur est verrouillé hors du système d’exploitation Windows.
Nom
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Override (« Name »), MappingStrings (« Win32API |Network Management Structures|name »)
Nom du compte d’utilisateur Windows sur le domaine spécifié par la propriété Domain de cette classe.
Exemple : « danwilson ».
Cette propriété est héritée de CIM_ManagedSystemElement.
PasswordChangeable
-
Type de données : booléen
-
Type d’accès : lecture/écriture
-
Qualificateurs : MappingStrings (« Win32API|Network Management Structures|USER_INFO_2||UF_PASSWD_CANT_CHANGE »)
Si la valeur est true, le mot de passe de ce compte d’utilisateur peut être modifié.
PasswordExpires
-
Type de données : booléen
-
Type d’accès : lecture/écriture
-
Qualificateurs : MappingStrings (« Win32API|Network Management Structures|USER_INFO_2||UF_DONT_EXPIRE_PASSWD »)
Si la valeur est true, le mot de passe de ce compte d’utilisateur expire.
PasswordRequired
-
Type de données : booléen
-
Type d’accès : lecture/écriture
-
Qualificateurs : MappingStrings (« Win32API|Network Management Structures|USER_INFO_2||UF_PASSWD_NOTREQD »)
Si la valeur est true, un mot de passe est requis sur un compte d’utilisateur Windows. Si la valeur est false, ce compte ne nécessite pas de mot de passe.
SID
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Fixed, MappingStrings (« Win32API|Security Identifiers (SIDs) »)
Identificateur de sécurité (SID) pour ce compte. Un SID est une valeur de chaîne de longueur variable utilisée pour identifier un client approuvé. Chaque compte a un SID unique qu’une autorité, telle qu’un domaine Windows, émet. Le SID est stocké dans une base de données de sécurité. Lorsqu’un utilisateur se connecte, le système récupère le SID utilisateur à partir de la base de données, place le SID dans le jeton d’accès utilisateur, puis utilise le SID dans le jeton d’accès utilisateur pour identifier l’utilisateur dans toutes les interactions suivantes avec la sécurité Windows. Chaque SID est un identificateur unique pour un utilisateur ou un groupe, et un utilisateur ou un groupe différent ne peut pas avoir le même SID.
Cette propriété est héritée de Win32_Account.
SIDType
-
Type de données : uint8
-
Type d'accès : Lecture seule
-
Qualificateurs : Fixed, MappingStrings (« Win32API|Access Control Enumeration Types|SID_NAME_USE »)
Valeur énumérée qui spécifie le type de SID.
Cette propriété est héritée de Win32_Account.
SidTypeUser (1)
SidTypeGroup (2)
SidTypeDomain (3)
SidTypeAlias (4)
SidTypeWellKnownGroup (5)
SidTypeDeletedAccount (6)
SidTypeInvalid (7)
SidTypeUnknown (8)
SidTypeComputer (9)
État
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (10), DisplayName ("Status")
État actuel d’un objet. Vous pouvez définir divers états opérationnels et non opérationnels. Les états opérationnels sont : « OK », « Degraded » et « Pred Fail », qui est un élément comme un lecteur de disque dur doté de la technologie SMART qui peut fonctionner correctement, tout en prédisant une défaillance dans un avenir proche. Les états non opérationnels incluent : « Error », « Starting », « Stopping » et « Service », qui peuvent s’appliquer pendant la réargenture de miroir d’un disque, le rechargement de la liste d’autorisations d’un utilisateur ou tout autre travail administratif.
Cette propriété est héritée de CIM_ManagedSystemElement.
Les valeurs sont notamment les suivantes :
OK (« OK »)
Error (« Erreur »)
Degraded (« Dégradé »)
Unknown (« Inconnu »)
Pred Fail (« Prédiction de défaillance »)
Starting (« Démarrage »)
Stopping (« Arrêt »)
Service (« Service »)
Stressed (« Stressé »)
NonRecover (« Pas de récupération »)
No Contact (« Aucun contact »)
Lost Comm (« Communication perdue »)
Notes
La classe Win32_UserAccount est dérivée de Win32_Account.
Remarque
Une erreur n’est pas retournée pour une tentative d’écriture dans une propriété en lecture seule et la valeur de la propriété reste inchangée.
Exemples
L’exemple de code VBScript suivant vous montre comment obtenir le nom complet d’un utilisateur sur un ordinateur local. Le nom complet est le nom complet en langage humain, par exemple, une personne peut avoir le nom d’utilisateur « kensanchez » et le nom complet peut être « Ken Sanchez », donc vous remplacez le nom de domaine réel et le nom d’utilisateur par « MyDomainName » et « MyUserName ». Pour une requête efficace, vous devez spécifier les propriétés du domaine et du nom d’utilisateur.
Si vous êtes administrateur sur un ordinateur distant, vous pouvez attribuer le nom de l’ordinateur distant pour strComputer (au lieu de « »), puis utiliser le type de script suivant pour obtenir le nom complet d’un compte d’utilisateur sur un ordinateur local à partir d’un ordinateur distant.
On Error Resume Next
strComputer = "."
Set objUserAccount = GetObject("winmgmts{impersonationLevel=impersonate}!\\" & strComputer _
& "\root\cimv2:Win32_UserAccount.Domain='MyDomainName',Name='MyUserName' ")
If Err = 0 Then
WScript.Echo objUserAccount.FullName
Else
WScript.Echo "No object found" & Err.Number
End If
using System.Management;
{
ManagementScope mgmtScope = new ManagementScope("\\\\.\\Root\\CIMv2");
ObjectQuery oQuery = new ObjectQuery("SELECT * FROM Win32_UserAccount Where Name=\"myUserName\"");
ManagementObjectSearcher mgmtSearch = new ManagementObjectSearcher(mgmtScope, oQuery);
ManagementObjectCollection objCollection = mgmtSearch.Get();
foreach (ManagementObject mgmtObject in objCollection)
{
Console.WriteLine("Full Name : {0}", mgmtObject["FullName"]);
}
}
Configuration requise
| Condition requise | Value |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Voir aussi