Win32_Group clase

La clase WMIde Win32_Group representa datos sobre una cuenta de grupo. Una cuenta de grupo permite cambiar los privilegios de acceso para una lista de usuarios. Ejemplo: Marketing2.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.

Sintaxis

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

Miembros

La clase Win32_Group tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

La clase Win32_Group tiene estos métodos.

Método	Descripción
Cambiar nombre	Cambia el nombre del grupo.

Propiedades

La clase Win32_Group tiene estas propiedades.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Descripción textual breve del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Dominio

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Invalidación ("Dominio"), MappingStrings ("Win32API| Funciones de administración de red|nombreDeDominio")

Nombre del dominio de Windows al que pertenece la cuenta de grupo.

Ejemplo: "NA-SALES"

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

LocalAccount

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: corregidos

Si es TRUE, la cuenta se define en el equipo local. Para recuperar solo las cuentas definidas en el equipo local, diseñe una consulta que incluya la condición "LocalAccount=TRUE".

Esta propiedad se hereda de Win32_Account.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Invalidación ("Name"), MappingStrings ("Win32API| Estructuras de administración de redes|nombre")

Nombre de la cuenta de grupo de Windows en el dominio especificado por la propiedad Domain de esta clase.

SID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Corregido, MappingStrings ("Win32API| Identificadores de seguridad (SID)")

Identificador de seguridad (SID) de esta cuenta. Un SID es un valor de cadena de longitud variable que se usa para identificar a un administrador de confianza. Cada cuenta tiene un SID único emitido por una autoridad (como un dominio de Windows), almacenado en una base de datos de seguridad. Cuando un usuario inicia sesión, el sistema recupera el SID del usuario de la base de datos y lo coloca en el token de acceso del usuario. El sistema usa el SID en el token de acceso del usuario para identificar al usuario en todas las interacciones posteriores con la seguridad de Windows. Cuando se ha usado un SID como identificador único para un usuario o grupo, no se puede usar de nuevo para identificar a otro usuario o grupo.

Esta propiedad se hereda de Win32_Account.

SIDType

Tipo de datos: uint8

Tipo de acceso: solo lectura

Calificadores: Corregido, MappingStrings ("Win32API|Access Control Tipos de enumeración | SID_NAME_USE")

Valores enumerados que especifican el tipo de identificador de seguridad (SID).

Esta propiedad se hereda de Win32_Account.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Cadena que indica el estado actual del objeto. Se puede definir el estado operativo y no operativo. El estado operativo puede incluir "Aceptar", "Degradado" y "Error previo". "Error previo" indica que un elemento funciona correctamente, pero predice un error (por ejemplo, una unidad de disco duro habilitada para SMART).

El estado no operativo puede incluir "Error", "Inicio", "Detención" y "Servicio". "Servicio" se puede aplicar durante el resilvering de reflejo del disco, volver a cargar una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "OK" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Pred Fail ("Pred Fail ")

Inicio ("Inicio")

Detención ("Detención ")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

Comentarios

La clase Win32_Group se deriva de Win32_Account.

Ejemplos

El código siguiente, tomado del ejemplo de código List Local Groups Using WMI VBScript en TechNet Gallery, usa Win32_Group para devolver información sobre los grupos locales que se encuentran en un equipo.

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 

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

Win32_Account

Clases de sistema operativo