clase Win32_UserAccount

  • Artículo

El Win32_UserAccountde clase WMIcontiene información sobre una cuenta de usuario en un sistema informático que ejecuta Windows.

Nota:

Dado que tanto el Nombre como el deDominioson propiedades clave, la enumeración de Win32_UserAccount en una red grande puede afectar negativamente al rendimiento. Llamar a GetObject o consultar una instancia específica tiene menos impacto.

 

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

Sintaxis

[Dynamic, Provider("CIMWin32"), UUID("{8502C4CC-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_UserAccount : Win32_Account
{
  uint32   AccountType;
  string   Caption;
  string   Description;
  boolean  Disabled;
  string   Domain;
  string   FullName;
  datetime InstallDate;
  boolean  LocalAccount;
  boolean  Lockout;
  string   Name;
  boolean  PasswordChangeable;
  boolean  PasswordExpires;
  boolean  PasswordRequired;
  string   SID;
  uint8    SIDType;
  string   Status;
};

Miembros

La clase Win32_UserAccount tiene estos tipos de miembros:

Métodos

La clase Win32_UserAccount tiene estos métodos.

Method Descripción
Cambiar nombre Permite cambiar el nombre de la cuenta de usuario.

 

Propiedades

La clase Win32_UserAccount tiene estas propiedades.

AccountType

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API|Estructuras de administración de red |USER_INFO_2|usri2_flags")

Marcas que describen las características de una cuenta de usuario de Windows.

Cuenta duplicada temporal (256)

UF_TEMP_DUPLICATE_ACCOUNT

Cuenta de usuario local para los usuarios que tienen una cuenta principal en otro dominio. Esta cuenta proporciona acceso de usuario a este dominio solo—a ningún dominio que confíe en este dominio.

Cuenta normal (512)

UF_NORMAL_ACCOUNT

Tipo de cuenta predeterminado que representa un usuario típico.

Cuenta de confianza de interdominio (2048)

UF_INTERDOMAIN_TRUST_ACCOUNT

Cuenta de un dominio del sistema que confía en otros dominios.

Cuenta de confianza de estación de trabajo(4096)

UF_WORKSTATION_TRUST_ACCOUNT

Cuenta de equipo de un sistema de equipo que ejecuta Windows que es miembro de este dominio.

Cuenta de confianza del servidor (8192)

UF_SERVER_TRUST_ACCOUNT

Cuenta de un controlador de dominio de copia de seguridad del sistema que es miembro de este dominio.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Dominio y nombre de usuario de la cuenta.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción de la cuenta.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Deshabilitado

Tipo de datos: booleano

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32API|Estructuras de administración de red |USER_INFO|UF_ACCOUNTDISABLE")

La cuenta de usuario de Windows está deshabilitada.

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 una cuenta de usuario, por ejemplo: "NA-SALES".

FullName

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32API|Estructuras de administración de red |USER_INFO_2|usri2_full_name")

Nombre completo de un usuario local, por ejemplo: "Dan Wilson".

InstallDate

Tipo de datos: fecha/hora

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Install Date")

Fecha de instalación del objeto. Esta propiedad no requiere un valor para indicar que el objeto está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

LocalAccount

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: Fijo

Si verdadero, la cuenta se define en el equipo local.

Esta propiedad se hereda de Win32_Account.

Bloqueo

Tipo de datos: booleano

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32API|Estructuras de administración de red |USER_INFO_2|UF_LOCKOUT")

Siverdadero, la cuenta de usuario se bloquea en el sistema operativo Windows.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Nombre de la cuenta de usuario de Windows en el dominio que especifica la propiedad Dominio de esta clase.

Ejemplo: "danwilson".

Esta propiedad se hereda de CIM_ManagedSystemElement.

PasswordChangeable

Tipo de datos: booleano

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32API|Estructuras de administración de red |USER_INFO_2|UF_PASSWD_CANT_CHANGE")

Si verdadero, se puede cambiar la contraseña de esta cuenta de usuario.

PasswordExpires

Tipo de datos: booleano

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32API|Estructuras de administración de red |USER_INFO_2|UF_DONT_EXPIRE_PASSWD")

Si true, la contraseña de esta cuenta de usuario expira.

PasswordRequired

Tipo de datos: booleano

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32API|Estructuras de administración de red |USER_INFO_2|UF_PASSWD_NOTREQD")

Si verdadero, se requiere una contraseña en una cuenta de usuario de Windows. Si falso, esta cuenta no requiere una contraseña.

SID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores:Fixed, 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 que emite una autoridad, como un dominio de Windows. El SID se almacena en la base de datos de seguridad. Cuando un usuario inicia sesión, el sistema recupera el SID de usuario de la base de datos, coloca el SID en el token de acceso de usuario y, a continuación, usa el SID en el token de acceso de usuario para identificar al usuario en todas las interacciones posteriores con la seguridad de Windows. Cada SID es un identificador único para un usuario o grupo, y un usuario o grupo diferentes no pueden tener el mismo SID.

Esta propiedad se hereda de Win32_Account.

SIDType

Tipo de datos: uint8

Tipo de acceso: solo lectura

Calificadores: fijo, MappingStrings ("Win32API|Tipos de enumeración de control de acceso |SID_NAME_USE")

Valor enumerado que especifica el tipo de 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")

Estado actual de un objeto. Se pueden definir varios estados operativos y no operativos. Los estados operativos incluyen: "Ok", "Degradado" y "Pred Fail", que es un elemento como una unidad de disco duro habilitada para SMART que puede funcionar correctamente, pero predice un error en un futuro próximo. Los estados no operativos incluyen: "Error", "Inicio", "Detención" y "Servicio", que se pueden aplicar durante la resilveración de reflejo de un disco, volver a cargar una lista de permisos de usuario u otro trabajo administrativo.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

OK ("OK")

Error ("Error")

Degraded ("Degraded")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Starting ("Starting")

Stopping ("Stopping")

Service ("Service")

Stressed ("Stressed")

NonRecover ("NonRecover")

No Contact ("No Contact")

Lost Comm ("Lost Comm")

Comentarios

La clase Win32_UserAccount se deriva de Win32_Account.

Nota:

No se devuelve un error cuando se intenta escribir en una propiedad de solo lectura, y el valor de la propiedad permanece sin cambios.

 

Ejemplos

En el siguiente ejemplo de código de VBScript se muestra cómo obtener el nombre completo de un usuario en un equipo local. El nombre completo es el nombre del idioma humano, por ejemplo, una persona puede tener el nombre de usuario de "kensanchez" y el nombre completo puede ser "Ken Sánchez", por lo que sustituye el nombre de dominio real y el nombre de usuario de "MyDomainName" y "MyUserName". Para una consulta eficaz, debe especificar las propiedades de dominio y nombre de usuario.

Si es administrador en un equipo remoto, puede asignar el nombre del equipo remoto para strComputer (en lugar de ".") y, a continuación, usar el siguiente tipo de script para obtener el nombre completo de una cuenta de usuario en un equipo local desde un equipo—remoto.

On Error Resume Next
strComputer = "."

Set objUserAccount = GetObject("winmgmts{impersonationLevel=impersonate}!\\" & strComputer _
    & "\root\cimv2:Win32_UserAccount.Domain='MyDomainName',Name='MyUserName' ")

If Err = 0 Then
    WScript.Echo objUserAccount.FullName
Else
    WScript.Echo "No object found" & Err.Number
End If

using System.Management;

{
     ManagementScope mgmtScope = new ManagementScope("\\\\.\\Root\\CIMv2");
     ObjectQuery oQuery = new ObjectQuery("SELECT * FROM Win32_UserAccount Where Name=\"myUserName\"");
     ManagementObjectSearcher mgmtSearch = new ManagementObjectSearcher(mgmtScope, oQuery);
     ManagementObjectCollection objCollection = mgmtSearch.Get();
     foreach (ManagementObject mgmtObject in objCollection)
     {
          Console.WriteLine("Full Name : {0}", mgmtObject["FullName"]);
     }
}

Requisitos

Requisito Valor
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