Win32_Group-Klasse

Die Win32_GroupWMI-Klasse 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 die folgenden Membertypen:

• Methoden
• Eigenschaften

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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Textbeschreibung des -Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Domäne

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

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 bedeutet nicht, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

LocalAccount

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: Behoben

Wenn 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.

Diese Eigenschaft wird von Win32_Account geerbt.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

Name des Windows-Gruppenkontos in der Domäne, die durch die Domain-Eigenschaft dieser Klasse angegeben wird.

SID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Behoben, MappingStrings ("Win32API| Sicherheitsbezeichner (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.

Diese Eigenschaft wird von Win32_Account geerbt.

SIDType

Datentyp: uint8

Zugriffstyp: Schreibgeschützt

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

Aufgezählte Werte, die den Typ des Sicherheitsbezeichners (SID) angeben.

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")

Zeichenfolge, die den aktuellen status des Objekts angibt. Es können operative und nicht operative status definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" 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", "Stop" und "Service" enthalten. "Dienst" kann beim Spiegel des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

Bemerkungen

Die Win32_Group-Klasse wird von Win32_Account abgeleitet.

Beispiele

Der folgende Code aus dem Codebeispiel Auflisten lokaler Gruppen mithilfe von WMI VBScript im TechNet-Katalog verwendet Win32_Group , um Informationen zu den lokalen Gruppen auf einem Computer zurückzugeben.

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)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Win32_Account

Betriebssystemklassen