_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 |
|
| DLL |
|