Win32_Account-Klasse

Die Win32_Account abstrakte WMI-Klasse enthält Informationen zu Benutzerkonten und Gruppenkonten, die dem Computersystem unter Windows bekannt sind. Benutzer- oder Gruppennamen, die von einer Windows-Domäne erkannt werden, sind Nachfolger (oder Mitglieder) dieser Klasse.

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

Syntax

[Abstract, UUID("{8502C4C9-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Account : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  string   Domain;
  datetime InstallDate;
  boolean  LocalAccount;
  string   Name;
  string   SID;
  uint8    SIDType;
  string   Status;
};

Member

Die Win32_Account-Klasse verfügt über folgende Membertypen:

Eigenschaften

Die Win32_Account-Klasse verfügt über diese Eigenschaften.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Kurze Beschreibung des Objekts.

Diese Eigenschaft wird von der CIM_ManagedSystemElement-Klasse geerbt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Beschreibung des Objekts.

Diese Eigenschaft wird von der CIM_ManagedSystemElement-Klasse geerbt.

Domäne

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Name der Windows-Domäne, zu der eine Gruppe oder ein Benutzer gehört.

Beispiel: "NA-SALES"

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

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

Datum und Uhrzeit der Installation des Objekts. Für diese Eigenschaft ist kein Wert erforderlich, um anzugeben, dass das Objekt installiert ist.

Diese Eigenschaft wird von der CIM_ManagedSystemElement-Klasse geerbt.

LocalAccount

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: Behoben

Bei TRUE wird das Konto auf dem lokalen Computer definiert. Um nur Konten abzurufen, die auf dem lokalen Computer definiert sind, entwerfen Sie eine Abfrage, die die Bedingung "LocalAccount=TRUE" enthält.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Außerkraftsetzung ("Name"), Schlüssel, MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen|Name")

Name des Windows-Systemkontos in der Domäne, die durch die Domain-Eigenschaft dieser Klasse angegeben wird. Diese Eigenschaft überschreibt die Name-Eigenschaft , die von CIM_ManagedSystemElement geerbt wird.

SID

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Sicherheits-ID (SID) für dieses Konto. Eine SID ist ein Zeichenfolgenwert mit variabler Länge, der zum Identifizieren eines Treuhänders verwendet wird. Jedes Konto verfügt über eine eindeutige SID, die von einer Autorität (z. B. einer Windows-Domäne) ausgestellt wurde und in einer Sicherheitsdatenbank gespeichert ist. Wenn sich ein Benutzer anmeldet, ruft das System die SID des Benutzers aus der Datenbank ab und platziert sie im Zugriffstoken des Benutzers. Das System verwendet die SID im Zugriffstoken des Benutzers, um den Benutzer bei allen nachfolgenden Interaktionen mit der Windows-Sicherheit zu identifizieren. Wenn eine SID als eindeutiger Bezeichner für einen Benutzer oder eine Gruppe verwendet wurde, kann sie nicht erneut verwendet werden, um einen anderen Benutzer oder eine Andere Gruppe zu identifizieren.

SIDType

Datentyp: uint8

Zugriffstyp: Schreibgeschützt

Qualifizierer: Behoben, MappingStrings ("Win32API|Access Control Enumerationstypen| SID_NAME_USE")

Aufzählungswerte, die den Typ der Sicherheits-ID (SID) angeben.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10), DisplayName ("Status")

Aktuelle status des Objekts. Es können verschiedene betriebsbezogene und nicht operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. eine SMART-fähige Festplatte, funktioniert möglicherweise ordnungsgemäß, sagt aber in naher Zukunft einen Fehler voraus). Zu den nicht betriebsbereiten Status gehören: "Fehler", "Wird gestartet", "Wird beendet" und "Dienst". Letzteres, "Dienst", kann während der Spiegel-Resilvering eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben gelten. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von der CIM_ManagedSystemElement-Klasse geerbt.

Die Werte sind:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Beenden ("Wird beendet")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

Bemerkungen

Die Win32_Account-Klasse wird von CIM_LogicalElement abgeleitet.

Beispiele

Der folgende PowerShell-Code ruft die lokalen Konten ab.

Get-WmiObject Win32_Account -Filter "Domain='$Env:ComputerName'"

Der folgende PowerShell-Code ruft die Domänenkonten ab.

 Get-WmiObject Win32_Account -Filter "Domain='$Env:UserDomain'" 

Anforderungen

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

Siehe auch

CIM_LogicalElement

Betriebssystemklassen