Win32 _ Group-Klasse
Die WMI-Klasse der Win32-Gruppe _ stellt Daten zu einem Gruppenkonto dar. Mit einem Gruppenkonto können Zugriffsberechtigungen für eine Liste von Benutzern geändert werden. Beispiel: Marketing2.
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
[Dynamic, Provider("CIMWin32"), UUID("{8502C4CB-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Group : Win32_Account
{
string Caption;
string Description;
datetime InstallDate;
string Status;
boolean LocalAccount;
string SID;
uint8 SIDType;
string Domain;
string Name;
};
Member
Die Win32 _ Group-Klasse verfügt über diese Typen von Membern:
Methoden
Die Win32 _ Group-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Umbenennen | Ändert den Gruppennamen. |
Eigenschaften
Die Win32 _ Group-Klasse verfügt über diese Eigenschaften.
-
Caption
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), DisplayName ("Caption")
Eine kurze Textbeschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
-
-
Beschreibung
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Beschreibung")
Eine Textbeschreibung des -Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
-
-
Domäne
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Überschreiben ("Domäne"), MappingStrings ("Domänenname der Win32API-Netzwerkverwaltungsfunktionen") | |
Name der Windows Domäne, zu der das Gruppenkonto gehört.
Beispiel: "NA-SALES"
-
-
InstallDate
-
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | ComponentID | 001.5"), DisplayName ("Installationsdatum")
Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
-
-
LocalAccount
-
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Behoben
True gibt an, dass das Konto auf dem lokalen Computer definiert ist. Um nur auf dem lokalen Computer definierte Konten abzurufen, entwerfen Sie eine Abfrage, die die Bedingung "LocalAccount=TRUE" enthält.
Diese Eigenschaft wird vom _ Win32-Kontogeerbt.
-
-
Name
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Überschreiben ("Name"), MappingStrings ("Name der Win32API-Netzwerkverwaltungsstrukturen") | |
Name des Windows Gruppenkontos in der Domäne, die von der Domain-Eigenschaft dieser Klasse angegeben wird.
-
-
SID
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Behoben: , MappingStrings ("Win32API-Sicherheitsbezeichner | (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 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 in allen nachfolgenden Interaktionen mit 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.
Diese Eigenschaft wird vom _ Win32-Kontogeerbt.
-
-
SIDType
-
-
Datentyp: uint8
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Behoben: , MappingStrings ("Win32API | Access Control Enumerationstypen | SID NAME _ _ USE")
Aufzählte Werte, die den Typ der Sicherheits-ID (SID) angeben.
Diese Eigenschaft wird vom _ Win32-Kontogeerbt.
-
-
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")
Zeichenfolge, die den aktuellen Status des Objekts angibt. Der Betriebsstatus und der nicht betriebsbereite Status können definiert werden. Der Betriebsstatus kann "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. ein SMART-fähiges Festplattenlaufwerk).
Nicht betriebsbereite Status können "Error", "Starting", "Stopping" und "Service" sein. "Dienst" kann während der Datenträgerspiegelung, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle dieser Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
Folgende Werte sind gültig:
OK ("OK")
Fehler ("Fehler")
Heruntergestuft ("Heruntergestuft")
Unbekannt ("Unbekannt")
Pred Fail ("Pred Fail")
Wird gestartet ("Wird gestartet")
Wird beendet ("Wird beendet")
Dienst ("Dienst")
Striche ("Strich")
NonRecover ("NonRecover")
Kein Kontakt ("Kein Kontakt")
Lost Comm ("Lost Comm")
Hinweise
Die Win32 _ Group-Klasse wird von Win32 _ Account abgeleitet.
Beispiele
Der folgende Code, der aus dem Codebeispiel List Local Groups Using WMI VBScript (Auflisten lokaler Gruppen mithilfe von WMI VBScript) im TechNet-Katalog übernommen wurde, verwendet Win32 _ Group, um Informationen zu den lokalen Gruppen auf einem Computer zurücksingen.
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colItems = objWMIService.ExecQuery _
("Select * from Win32_Group Where LocalAccount = True")
For Each objItem in colItems
Wscript.Echo "Caption: " & objItem.Caption
Wscript.Echo "Description: " & objItem.Description
Wscript.Echo "Domain: " & objItem.Domain
Wscript.Echo "Local Account: " & objItem.LocalAccount
Wscript.Echo "Name: " & objItem.Name
Wscript.Echo "SID: " & objItem.SID
Wscript.Echo "SID Type: " & objItem.SIDType
Wscript.Echo "Status: " & objItem.Status
Wscript.Echo
Next
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|