classe Win32_Group

La classe WMI Win32_Grouprappresenta i dati relativi a un account di gruppo. Un account di gruppo consente di modificare i privilegi di accesso per un elenco di utenti. Esempio: Marketing2.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non in ordine MOF.

Sintassi

[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;
};

Membri

La classe Win32_Group ha questi tipi di membri:

• Metodi
• Proprietà

Metodi

La classe Win32_Group include questi metodi.

Metodo	Descrizione
Rinomina	Modifica il nome del gruppo.

Proprietà

La classe Win32_Group ha queste proprietà.

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

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

Breve descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Dominio

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override ("Dominio"), MappingStrings ("Win32API|Funzioni di gestione di rete|nomedominio")

Nome del dominio di Windows a cui appartiene l'account del gruppo.

Esempio: "NA-SALES"

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |ComponentID|001.5"), DisplayName ("Data di installazione")

Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

LocalAccount

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: fisso

Se TRUE, l'account viene definito nel computer locale. Per recuperare solo gli account definiti nel computer locale, progettare una query che includa la condizione "LocalAccount=TRUE".

Questa proprietà viene ereditata da Win32_Account.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override ("Name"), MappingStrings ("Win32API|Strutture di gestione di rete|nome")

Nome dell'account del gruppo di Windows nel dominio specificato dalla proprietà Domain di questa classe.

SID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Fixed, MappingStrings ("Win32API|Identificatori di sicurezza (SID)")

Identificatore di sicurezza (SID) per questo account. Un SID è un valore stringa di lunghezza variabile usato per identificare un trustee. Ogni account ha un SID univoco emesso da un'autorità (ad esempio un dominio di Windows), archiviato in un database di sicurezza. Quando un utente accede, il sistema recupera il SID dell'utente dal database e lo inserisce nel token di accesso dell'utente. Il sistema usa il SID nel token di accesso dell'utente per identificare l'utente in tutte le interazioni successive con la sicurezza di Windows. Quando un SID è stato usato come identificatore univoco per un utente o un gruppo, non può essere usato di nuovo per identificare un altro utente o gruppo.

Questa proprietà viene ereditata da Win32_Account.

SIDType

Tipo di dati: uint8

Tipo di accesso: sola lettura

Qualificatori: Fixed, MappingStrings ("Win32API|Controllo di accesso Tipi di enumerazione |SID_NAME_Uedizione Standard")

Valori enumerati che specificano il tipo di identificatore di sicurezza (SID).

Questa proprietà viene ereditata da Win32_Account.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Stato

Tipo di dati: string

Tipo di accesso: sola lettura

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

Stringa che indica lo stato corrente dell'oggetto. È possibile definire lo stato operativo e non operativo. Lo stato operativo può includere "OK", "Danneggiato" e "Pred Fail". "Pred Fail" indica che un elemento funziona correttamente, ma prevede un errore (ad esempio, un'unità disco rigido abilitata per SMART).

Lo stato non operativo può includere "Error", "Starting", "Stopping" e "Service". Il "servizio" può essere applicato durante il ridimensionamento del mirroring del disco, il ricaricamento di un elenco di autorizzazioni utente o altre operazioni amministrative. Non tutte queste operazioni sono online, ma l'elemento gestito non è né "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore ")

Degradato ("degradato")

Sconosciuto ("Sconosciuto")

Pred Fail ("Pred Fail ")

Avvio ("Starting ")

Arresto ("arresto ")

Servizio ("Servizio")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

Osservazioni:

La classe Win32_Group deriva da Win32_Account.

Esempi

Il codice seguente usa Win32_Group per restituire informazioni sui gruppi locali trovati in un computer.

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 

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Win32_Account

Classi del sistema operativo