Klasse „Win32_UserAccount“

  • Artikel

Die WMI-KlasseWin32\_UserAccount enthält Informationen zu einem Benutzerkonto auf einem Computersystem unter Windows.

Hinweis

Da Name und Domain Schlüsseleigenschaften sind kann sich das Auflisten von Win32_UserAccount in einem großen Netzwerk negativ auf die Leistung auswirken. Das Aufrufen von GetObject oder Abfragen einer bestimmten Instanz hat geringere Auswirkungen.

 

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften und Methoden werden in alphabetischer Reihenfolge aufgeführt, nicht in 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 Klasse Win32_ServerFeature verfügt über die folgenden Elementtypen:

Methoden

Die Klasse Win32_UserAccount verfügt über die folgenden Methoden.

Methode Beschreibung
Umbenennen Ermöglicht die Umbenennung des Benutzerkontos.

 

Eigenschaften

Die Klasse Win32_UserAccount verfügt über die folgenden Eigenschaften.

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 dupliziertes Konto (256)

UF_TEMP_DUPLICATE_ACCOUNT

Lokales Benutzerkonto für Benutzer*innen, die über ein primäres Konto in einer anderen Domäne verfügen. Dieses Konto ermöglicht Benutzerzugriff nur auf diese Domäne, nicht auf eine Domäne, für die diese Domäne als vertrauenswürdig gilt.

Normales Konto (512)

UF_NORMAL_ACCOUNT

Standardkontotyp, der typische Benutzer*innen darstellt.

Domänenübergreifendes Vertrauenskonto (2048)

UF_INTERDOMAIN_TRUST_ACCOUNT

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

Arbeitsstationsvertrauenskonto (4096)

UF_WORKSTATION_TRUST_ACCOUNT

Computerkonto für ein Computersystem unter Windows, das Mitglied dieser Domäne ist.

Serververtrauenskonto (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 Wert

Zugriffstyp: Lesen/Schreiben

Qualifizierer: MappingStrings ("Win32API|Netzwerkverwaltungsstrukturen|USER_INFO|UF_ACCOUNTDISABLE")

Windows-Benutzerkonto ist deaktiviert.

Domäne

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Override ("Domäne"), MappingStrings ("Win32API|Netzwerkverwaltungsfunktionen|Domänenname")

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

FullName

Datentyp: Zeichenfolge

Zugriffstyp: Lesen/Schreiben

Qualifizierer: MappingStrings ("Win32API|Netzwerkverwaltungsstrukturen|USER_INFO_2|usri2_full_name")

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

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Installationsdatum")

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

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

LocalAccount

Datentyp: Boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: Fixed

Bei true ist das Konto auf dem lokalen Computer definiert.

Diese Eigenschaft wird von Win32_Account geerbt.

Sperre

Datentyp: Boolescher Wert

Zugriffstyp: Lesen/Schreiben

Qualifizierer: MappingStrings ("Win32API|Netzwerkverwaltungsstrukturen|USER_INFO_2|UF_LOCKOUT")

Bei true ist das Benutzerkonto im Windows-Betriebssystem gesperrt.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Override ("Name"), MappingStrings ("Win32API|Netzwerkverwaltungsstrukturen|name")

Der Name des Windows-Benutzerkontos in der Domäne, die mit der Eigenschaft Domain dieser Klasse angegeben wird.

Beispiel: danwilson.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

PasswordChangeable

Datentyp: Boolescher Wert

Zugriffstyp: Lesen/Schreiben

Qualifizierer: MappingStrings ("Win32API|Netzwerkverwaltungsstrukturen|USER_INFO_2|UF_PASSWD_CANT_CHANGE")

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

PasswordExpires

Datentyp: Boolescher Wert

Zugriffstyp: Lesen/Schreiben

Qualifizierer: MappingStrings ("Win32API|Netzwerkverwaltungsstrukturen|USER_INFO_2|UF_DONT_EXPIRE_PASSWD")

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

PasswordRequired

Datentyp: Boolescher Wert

Zugriffstyp: Lesen/Schreiben

Qualifizierer: MappingStrings ("Win32API|Netzwerkverwaltungsstrukturen|USER_INFO_2|UF_PASSWD_NOTREQD")

Bei true ist für ein Windows-Benutzerkonto ein Kennwort erforderlich. Bei false erfordert dieses Konto kein Kennwort.

SID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Fixed, MappingStrings ("Win32API|Sicherheits-IDs (SIDs)")

Sicherheits-ID (SID) für dieses Konto. Eine SID ist ein Zeichenfolgenwert variabler Länge, der zum Identifizieren eines Vertrauensnehmers verwendet wird. Jedes Konto verfügt über eine eindeutige SID, die von einer entsprechenden Stelle, z. B. einer Windows-Domäne, ausgestellt wird. Die SID wird in der Sicherheitsdatenbank gespeichert. Wenn sich Benutzer*innen anmelden, ruft das System die Benutzer-SIDs aus der Datenbank ab, platziert die SIDs im Benutzerzugriffstoken und verwendet dann die SIDs im Benutzerzugriffstoken, um die Benutzer*innen in allen nachfolgenden Interaktionen mit der Windows-Sicherheit zu identifizieren. Jede SID ist ein eindeutiger Bezeichner für einen Benutzer/eine Benutzerin oder eine Gruppe, und andere Benutzer*innen oder Gruppen können nicht dieselbe SID haben.

Diese Eigenschaft wird von Win32_Account geerbt.

SIDType

Datentyp: uint8

Zugriffstyp: Schreibgeschützt

Qualifizierer: Fixed, MappingStrings ("Win32API|Zugriffssteuerungs-Enumerationstypen|SID_NAME_USE")

Aufgelisteter 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. Es können verschiedene betriebliche und nicht betriebliche Statuswerte definiert werden. Zu den betriebliche Statuswerten gehören: „OK“, „Herabgestuft“ und „Voraus Fehler“ (ein Element, z. B. eine SMART-fähige Festplatte, funktioniert möglicherweise ordnungsgemäß, prognostiziert aber für die nahe Zukunft einen Fehler). Die nicht betrieblichen Statuswerte umfassen: „Fehler“, „Wird gestartet“, „Wird beendet“ und „Dienst“. Sie gelten für das Spiegeln eines Datenträgers, das Neuladen einer Benutzerberechtigungsliste oder andere administrative Arbeiten.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Error ("Fehler")

Degraded ("Herabgestuft")

Unknown ("Unbekannt")

Pred Fail ("Voraus Fehler")

Starting ("Wird gestartet")

Stopping ("Wird beendet")

Service ("Dienst")

Stressed ("Belastet")

NonRecover ("NichtWiederherstellbar")

No Contact ("Kein Kontakt")

Lost Comm ("Verbindung getrennt")

Hinweise

Die Klasse Win32_UserAccount 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 folgende VBScript-Codebeispiel zeigt, wie Sie den vollständigen Namen eines Benutzers auf einem lokalen Computer abrufen. Der vollständige Name ist der Name in der menschlichen Sprache, z. B. kann eine Person den Benutzernamen „kensanchez“ haben, und der vollständige Name kann „Ken Sanchez“ sein. Sie können also den echten Domänennamen und Benutzernamen für „MyDomainName“ und „MyUserName“ ersetzen. Für eine effiziente Abfrage müssen Sie die Eigenschaften für den Domänennamen und den Benutzernamen angeben.

Wenn Sie Administratorrechte auf einem Remotecomputer haben, können Sie den Namen des Remotecomputers für „strComputer“ (statt „.“) zuweisen und dann den folgenden Skripttyp verwenden, um über einen Remotecomputer den vollständigen Namen eines Benutzerkontos auf einem lokalen Computer abzurufen.

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

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