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
CIMWin32.mof
DLL
CIMWin32.dll

Weitere Informationen

Win32-Konto _

Betriebssystemklassen