_Classe UserAccount Win32

La classe WMI _ UserAccount WMI contient des informations sur un compte d’utilisateur sur un système informatique exécutant Windows.

Notes

Étant donné que le nom et le domaine sont tous les deux des propriétés de clé, l’énumération de _ UserAccount Win32 sur un réseau de grande taille peut avoir un impact négatif sur 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 les types de membres suivants :

Méthodes

La classe Win32 _ UserAccount possède ces méthodes.

Méthode Description
Renommer Autorise l’attribution d’un nouveau nom au 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 | _ info User info _ 2 | usri2 _ Flags »)

indicateurs qui décrivent les caractéristiques d’un compte d’utilisateur Windows.

Compte dupliqué temporaire (256)

_ _ compte DUPLIQUÉ temporaire _ uf

Compte d’utilisateur local pour les utilisateurs qui ont un compte principal dans un autre domaine. Ce compte fournit un accès utilisateur à ce domaine uniquement, et non à un domaine qui approuve ce domaine.

Compte normal (512)

_compte standard _ uf

Type de compte par défaut qui représente un utilisateur standard.

Compte de confiance interdomaine (2048)

_compte de confiance interdomaine UF _ _

Compte d’un domaine système qui approuve d’autres domaines.

Compte de confiance de station de travail (4096)

compte d’approbation de station de _ travail UF _ _

compte d’ordinateur d’un système informatique exécutant Windows qui est membre de ce domaine.

Compte de confiance du serveur (8192)

_compte de _ confiance du serveur uf _

Compte d’un contrôleur de domaine de sauvegarde du 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 (« Caption »)

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.

Désactivé

Type de données : booléen

Type d’accès : lecture/écriture

Qualificateurs : MappingStrings (« win32api | Network Management structures | _ info utilisateur | UF _ ACCOUNTDISABLE »)

Windows compte d’utilisateur est désactivé.

Domaine

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : override ("Domain"), MappingStrings ("Win32APId | Network Management Functions | nom_domaine")

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 | _ Information User info _ 2 | usri2 _ Full _ Name»)

Nom complet d’un utilisateur local, par exemple : « Dan Wilson ».

InstallDate

Type de données : DateTime

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 d’une 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 : fixe

Si la valeur est true, le compte est défini sur l’ordinateur local.

Cette propriété est héritée du _ compte Win32.

Verrouillage.

Type de données : booléen

Type d’accès : lecture/écriture

Qualificateurs : MappingStrings (« win32api | Network Management structures | _ Information User info _ 2 | UF _ lockout»)

si la valeur est true, le compte d’utilisateur est verrouillé sur le 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 que la propriété de domaine de cette classe spécifie.

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 | _ Information User info _ 2 | UF passwd impossibilité _ _ _ 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 | _ info utilisateur _ 2uf ne pas faire | _ _ expirer _ 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 | _ Information User info _ 2 | UF _ passwd 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 requiert pas de mot de passe.

SID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : fixed, MappingStrings ("win32api, | identificateurs de sécurité (SID)")

Identificateur de sécurité (SID) pour ce compte. Un SID est une valeur de chaîne de longueur variable qui est utilisée pour identifier un tiers de confiance. chaque compte possède un SID unique qu’une autorité, par exemple un domaine Windows, émet. Le SID est stocké dans la base de données de sécurité. lorsqu’un utilisateur ouvre une session, le système récupère le sid de l’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 Windows sécurité. Chaque SID est un identificateur unique pour un utilisateur ou un groupe, et un autre utilisateur ou groupe ne peut pas avoir le même SID.

Cette propriété est héritée du _ compte Win32.

SIDType

Type de données : UInt8

Type d'accès : Lecture seule

Qualificateurs : fixed, MappingStrings ("win32api | Access Control types énumération types | sid _ _ use")

Valeur énumérée qui spécifie le type de SID.

Cette propriété est héritée du _ compte Win32.

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. Divers États opérationnels et inopérationnels peuvent être définis. Les États opérationnels sont les suivants : « OK », « détérioré » et « échec prédit », qui est un élément tel qu’un lecteur de disque dur intelligent qui peut fonctionner correctement, mais prédit une défaillance dans un avenir proche. Les États non opérationnels sont les suivants : « erreur », « démarrage », « arrêt » et « service », qui peuvent s’appliquer pendant la réargentation miroir d’un disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives.

Cette propriété est héritée de CIM _ ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« erreur »)

Détérioré (« détérioré »)

Inconnu ("inconnu")

Échec prévu (« échec prédit »)

Démarrage en cours (« démarrage »)

Arrêt en cours (« arrêt »)

Service (« service »)

Stressed (« stressed »)

Non récupéré (« non récupéré »)

Aucun contact (« aucun contact »)

Communication perdue (« inversée comm »)

Notes

La classe Win32 _ UserAccount est dérivée du _ compte Win32.

Notes

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 répertorier les comptes d’utilisateurs locaux à l’aide de code WMI VBScript sur la Galerie TechNet utilise Win32 _ UserAccount pour renvoyer des informations sur les comptes d’utilisateurs locaux détectés sur un ordinateur.

Traduire le SID en compte d’utilisateur et le compte d’utilisateur en sid L’exemple de code PowerShell sur la Galerie TechNet utilise Win32 _ UserAccount pour convertir un SID en compte d’utilisateur et/ou un compte d’utilisateur en sid.

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 de la langue humaine. par exemple, une personne peut avoir le nom d’utilisateur « kensanchez » et le nom complet peut être « Ken Sanchez ». vous devez donc remplacer 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 Domain et User Name.

Si vous êtes un 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"]);
     }
}

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

_Compte Win32

Classes du système d’exploitation