Win32_Account clase
La clase WMI abstracta Win32_Account contiene información sobre las cuentas de usuario y las cuentas de grupo conocidas para el sistema informático que ejecuta Windows. Los nombres de usuario o grupo reconocidos por un dominio de Windows son descendientes (o miembros) de esta clase.
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
[Abstract, UUID("{8502C4C9-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Account : CIM_LogicalElement
{
string Caption;
string Description;
string Domain;
datetime InstallDate;
boolean LocalAccount;
string Name;
string SID;
uint8 SIDType;
string Status;
};
Miembros
La clase Win32_Account tiene estos tipos de miembros:
Propiedades
La clase Win32_Account tiene estas propiedades.
-
Caption
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (64), DisplayName ("Caption")
Descripción breve del objeto.
Esta propiedad se hereda de la clase CIM_ManagedSystemElement .
-
-
Descripción
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Descripción")
Descripción del objeto .
Esta propiedad se hereda de la clase CIM_ManagedSystemElement .
-
-
Dominio
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: key, MappingStrings ("Win32API| Funciones de administración de red| Dominio")
Nombre del dominio de Windows al que pertenece un grupo o usuario.
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")
Fecha y hora en que se instaló el objeto. Esta propiedad no requiere un valor para indicar que el objeto está instalado.
Esta propiedad se hereda de la clase 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".
-
-
Nombre
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Invalidación ("Nombre"), clave, MappingStrings ("Win32API| Estructuras de administración de red|nombre")
Nombre de la cuenta del sistema de Windows en el dominio especificado por la propiedad Domain de esta clase. Esta propiedad invalida la propiedad Name heredada de CIM_ManagedSystemElement.
-
-
SID
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Corregido, MappingStrings ("Win32API| Identificadores de seguridad (SID)")
Identificador de seguridad (SID) para esta cuenta. Un SID es un valor de cadena de longitud variable que se usa para identificar 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 volver a usar para identificar a otro usuario o grupo.
-
-
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).
-
-
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")
Estado actual del objeto. Se pueden definir varios estados operativos y no operativos. Los estados operativos incluyen: "Ok", "Degradado" y "Error previo" (un elemento, como una unidad de disco duro habilitada para SMART, puede funcionar correctamente, pero predice un error en un futuro próximo). Los estados no operativos incluyen: "Error", "Inicio", "Detención" y "Servicio". Este último, "Servicio", se puede aplicar durante la resilveración de reflejo de un disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "CORRECTO" ni en uno de los otros estados.
Esta propiedad se hereda de la clase CIM_ManagedSystemElement .
Los valores son:
Ok ("OK")
Error ("Error")
Degradado ("Degradado")
Desconocido ("Desconocido")
Error previo ("Error previo")
Inicio ("Inicio")
Detener ("Detener")
Servicio ("Servicio")
Estresado ("Estresado")
NonRecover ("NonRecover")
Sin contacto ("Sin contacto")
Lost Comm ("Lost Comm")
Comentarios
La clase Win32_Account se deriva de CIM_LogicalElement.
Ejemplos
El siguiente código de PowerShell recupera las cuentas locales.
Get-WmiObject Win32_Account -Filter "Domain='$Env:ComputerName'"
El siguiente código de PowerShell recupera las cuentas de dominio.
Get-WmiObject Win32_Account -Filter "Domain='$Env:UserDomain'"
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|