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
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 |
|
| Archivo DLL |
|