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