Classe Win32_UserAccount

  • Article

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
CIMWin32.mof
DLL
CIMWin32.dll

Voir aussi

Win32_Account

Classes du système d’exploitation