Win32_UserAccount Klasse

Artikel
09/21/2022
5 Minuten Lesedauer

Die Win32_UserAccountWMI-Klasse enthält Informationen zu einem Benutzerkonto auf einem Computersystem, das Windows ausgeführt wird.

Hinweis

Da sowohl der Name als auch die Domäne wichtige Eigenschaften sind, können Win32_UserAccount in einem großen Netzwerk negativ auf die Leistung aufgezählt werden. Das Aufrufen von GetObject oder Abfrage für eine bestimmte Instanz hat weniger Auswirkungen.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften und Methoden sind in alphabetischer Reihenfolge, nicht MOF-Reihenfolge.

Syntax

[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;
};

Member

Die Win32_UserAccount-Klasse verfügt über diese Arten von Mitgliedern:

Methoden
Eigenschaften

Methoden

Die Win32_UserAccount Klasse weist diese Methoden auf.

Methode	BESCHREIBUNG
Umbenennen	Ermöglicht die Umbenennung des Benutzerkontos.

Eigenschaften

Die Win32_UserAccount Klasse weist diese Eigenschaften auf.

AccountType

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| USER_INFO_2|usri2_flags")

Flags, die die Merkmale eines Windows Benutzerkontos beschreiben.

Temporäres Duplikatkonto (256)

UF_TEMP_DUPLICATE_ACCOUNT

Lokales Benutzerkonto für Benutzer, die über ein primäres Konto in einer anderen Domäne verfügen. Dieses Konto bietet nur Zugriff auf diese Domäne – nicht für jede Domäne, die dieser Domäne vertrauen.

Normales Konto (512)

UF_NORMAL_ACCOUNT

Standardkontotyp, der einen typischen Benutzer darstellt.

Interdomain Trust Account (2048)

UF_INTERDOMAIN_TRUST_ACCOUNT

Konto für eine Systemdomäne, die anderen Domänen vertrauen.

Arbeitsstation-Vertrauenskonto (4096)

UF_WORKSTATION_TRUST_ACCOUNT

Computerkonto für ein Computersystem, das Windows ausgeführt wird, das mitglied dieser Domäne ist.

Serververtrauenswürdiges Konto (8192)

UF_SERVER_TRUST_ACCOUNT

Konto für einen Systemsicherungs-Domänencontroller, der Mitglied dieser Domäne ist.

Caption

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64), DisplayName ("Beschriftung ")

Domäne und Benutzername des Kontos.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Beschreibung

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Beschreibung")

Beschreibung des Kontos.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Deaktiviert

Datentyp: boolescher Datentyp
Access-Typ: Lese-/Schreibzugriff
Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| USER_INFO| UF_ACCOUNTDISABLE")

Windows Benutzerkonto ist deaktiviert.

Domäne

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: Außerkraftsetzung ("Domäne"), MappingStrings ("Win32API| Netzwerkverwaltungsfunktionen|domainname")

Name der Windows Domäne, zu der ein Benutzerkonto gehört, z. B. "NA-SALES".

FullName

Datentyp: Zeichenfolge
Access-Typ: Lese-/Schreibzugriff
Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | USER_INFO_2 usri2_full_name")

Vollständiger Name eines lokalen Benutzers, z. B. "Dan Wilson".

InstallDate

Datentyp: Datumszeit
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Datum, an dem das Objekt installiert ist. Diese Eigenschaft benötigt keinen Wert, um anzugeben, dass das Objekt installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

LocalAccount

Datentyp: boolescher Datentyp
Zugriffstyp: Schreibgeschützt
Qualifizierer: Behoben

Wenn true, wird das Konto auf dem lokalen Computer definiert.

Diese Eigenschaft wird von Win32_Account geerbt.

Sperrung

Datentyp: boolescher Datentyp
Access-Typ: Lese-/Schreibzugriff
Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | USER_INFO_2 UF_LOCKOUT")

Wenn true, wird das Benutzerkonto aus dem Windows Betriebssystem gesperrt.

Name

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: Überschreiben ("Name"), MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen|name")

Name des Windows Benutzerkontos in der Domäne, die die Domain-Eigenschaft dieser Klasse angibt.

Beispiel: "danwilson".

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

PasswordChangeable

Datentyp: boolescher Datentyp
Access-Typ: Lese-/Schreibzugriff
Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | USER_INFO_2 UF_PASSWD_CANT_CHANGE")

Wenn true, kann das Kennwort für dieses Benutzerkonto geändert werden.

PasswordExpires

Datentyp: boolescher Datentyp
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | USER_INFO_2 UF_DONT_EXPIRE_PASSWD")

Wenn true, läuft das Kennwort für dieses Benutzerkonto ab.

PasswordRequired

Datentyp: boolescher Datentyp
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | USER_INFO_2 UF_PASSWD_NOTREQD")

Wenn true, ist ein Kennwort für ein Windows Benutzerkonto erforderlich. Wenn "false", erfordert dieses Konto kein Kennwort.

SID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: Fixed, MappingStrings ("Win32API| Sicherheitsbezeichner (SIDs)")

Sicherheitsbezeichner (SID) für dieses Konto. Eine SID ist ein Zeichenfolgenwert der Variablenlänge, die verwendet wird, um einen Truste zu identifizieren. Jedes Konto verfügt über eine eindeutige SID, die eine Autorität, z. B. eine Windows Domäne, Probleme hat. Die SID wird in der Sicherheitsdatenbank gespeichert. Wenn sich ein Benutzer anmeldet, ruft das System die Benutzer-SID aus der Datenbank ab, platziert die SID im Benutzerzugriffstoken und verwendet dann die SID im Benutzerzugriffstoken, um den Benutzer in allen nachfolgenden Interaktionen mit Windows Sicherheit zu identifizieren. Jede SID ist ein eindeutiger Bezeichner für einen Benutzer oder eine Gruppe, und ein anderer Benutzer oder eine andere Gruppe kann nicht über dieselbe SID verfügen.

Diese Eigenschaft wird von Win32_Account geerbt.

SIDType

Datentyp: uint8
Zugriffstyp: Schreibgeschützt
Qualifizierer: Fixed, MappingStrings ("Win32API|Access Control Enumerationstypen| SID_NAME_USE")

Aufgezählter Wert, der den Typ der SID angibt.

Diese Eigenschaft wird von Win32_Account geerbt.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Status

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (10), DisplayName ("Status")

Aktueller Status eines Objekts. Verschiedene betriebs- und nichtoperationale Status können definiert werden. Betriebsstatus sind: "OK", "Degraded" und "Pred Fail", das ein Element wie eine SMART-aktivierte Festplatte ist, die möglicherweise ordnungsgemäß funktioniert, aber einen Fehler in naher Zukunft vorhergesagt. Nichtoperationale Status umfassen: "Error", "Starting", "Stop" und "Service", die während der Spiegelbeschriftung eines Datenträgers angewendet werden können, eine Benutzerberechtigungsliste neu laden oder andere administrative Arbeiten ausführen können.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK ")

Fehler ("Fehler ")

Beeinträchtigt ("Beeinträchtigt ")

Unbekannt ("Unbekannt ")

Pred Fail ("Pred Fail")

Start ("Start ")

Beenden ("Beenden ")

Dienst ("Dienst")

Betont ("betont")

NonRecover ("NonRecover ")

Kein Kontakt ("Kein Kontakt ")

Lost Comm ("Lost Comm ")

Bemerkungen

Die Win32_UserAccount Klasse wird von Win32_Account abgeleitet.

Hinweis

Ein Fehler wird nicht zurückgegeben, wenn versucht wird, in eine schreibgeschützte Eigenschaft zu schreiben, und der Wert der Eigenschaft bleibt unverändert.

Beispiele

Das Beispiel für lokale Benutzerkonten mithilfe des WMI VBScript-Codebeispiels in techNet Gallery verwendet Win32_UserAccount , um Informationen zu den lokalen Benutzerkonten auf einem Computer zurückgibt.

Die Übersetzungs-SID in Benutzerkonto und Benutzerkonto in SID PowerShell-Codebeispiel in TechNet Gallery verwendet Win32_UserAccount , um eine SID in Benutzerkonto und/oder ein Benutzerkonto in SID zu übersetzen.

Im folgenden VBScript-Codebeispiel wird gezeigt, wie Sie den vollständigen Namen eines Benutzers auf einem lokalen Computer abrufen. Der vollständige Name ist der Name der menschlichen Sprache, z. B. kann eine Person den Benutzernamen "kensanchez" haben, und der vollständige Name kann "Ken Sanchez" sein, sodass Sie den echten Domänennamen und den Benutzernamen für "MyDomainName" und "MyUserName" ersetzen. Für eine effiziente Abfrage müssen Sie sowohl die Domänen- als auch die Benutzernameneigenschaften angeben.

Wenn Sie ein Administrator auf einem Remotecomputer sind, können Sie den Namen des Remotecomputers für strComputer (statt ".") zuweisen und dann den folgenden Skripttyp verwenden, um den vollständigen Namen eines Benutzerkontos auf einem lokalen Computer abzurufen – von einem Remotecomputer aus.

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"]);
     }
}

Requirements (Anforderungen)

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Win32_Account
Betriebssystemklassen

Win32_UserAccount Klasse

Syntax

Member

Methoden

Eigenschaften

Bemerkungen

Beispiele

Requirements (Anforderungen)

Siehe auch

Zusätzliche Ressourcen

Zusätzliche Ressourcen