Classe Win32_UserAccount

  • Artigo

A classe WMI Win32_UserAccount contém informações sobre uma conta de usuário em um sistema de computador que executa o Windows.

Observação

Como o Nome e o Domínio são propriedades-chave, enumerar Win32_UserAccount em uma rede grande pode afetar negativamente o desempenho. Chamar GetObject ou consultar uma instância específica tem menos impacto.

 

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades e os métodos estão em ordem alfabética e não em ordem MOF.

Sintaxe

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

Membros

A classe Win32_UserAccount tem esses tipos de membros:

Métodos

A classe Win32_UserAccount tem esses métodos.

Método Descrição
Renomear Permite a renomeação da conta de usuário.

 

Propriedades

A classe Win32_UserAccount tem essas propriedades.

AccountType

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API|Estruturas de gerenciamento de rede|USER_INFO_2|usri2_flags")

Sinalizadores que descrevem as características de uma conta de usuário do Windows.

Conta duplicada temporária (256)

UF_TEMP_DUPLICATE_ACCOUNT

Conta de usuário local para usuários que têm uma conta principal em outro domínio. Essa conta fornece ao usuário acesso somente a esse domínio, não a qualquer domínio que confie nesse domínio.

Conta normal (512)

UF_NORMAL_ACCOUNT

Tipo de conta padrão que representa um usuário típico.

Conta de confiança entre domínios (2048)

UF_INTERDOMAIN_TRUST_ACCOUNT

Conta para um domínio do sistema que confia em outros domínios.

Conta de confiança da estação de trabalho (4096)

UF_WORKSTATION_TRUST_ACCOUNT

Conta de computador para um sistema de computador executando o Windows que seja membro deste domínio.

Conta de confiança do servidor (8192)

UF_SERVER_TRUST_ACCOUNT

Conta para um controlador de domínio de backup do sistema que seja membro deste domínio.

Legenda

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), DisplayName ("Legenda")

Domínio e nome de usuário da conta.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Descrição

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Descrição da conta.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Desabilitado

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Qualificadores: MappingStrings ("Win32API|Estruturas de gerenciamento de rede||USER_INFO|UF_ACCOUNTDISABLE")

A conta de usuário do Windows está desabilitada.

Domínio

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Substituir ("Domínio"), MappingStrings ("Win32API|Funções de gerenciamento de rede|nome de domínio")

Nome do domínio do Windows ao qual uma conta de usuário pertence, por exemplo: "NA-SALES".

FullName

Tipo de dados: string

Tipo de acesso: leitura/gravação

Qualificadores: MappingStrings ("Win32API|Estruturas de gerenciamento de rede|USER_INFO_2|usri2_full_name")

Nome completo de um usuário local, por exemplo: "Dan Wilson".

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF|ComponentID|001.5"), DisplayName ("Data de Instalação")

Data em que o objeto é instalado. Essa propriedade não requer um valor para indicar que o objeto está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

LocalAccount

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: Fixo

Se true, a conta é definida no computador local.

Essa propriedade é herdada de Win32_Account.

Bloquear

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Qualificadores: MappingStrings ("Win32API|Estruturas de gerenciamento de rede|USER_INFO_2|UF_LOCKOUT")

Se true, a conta de usuário está bloqueada fora do sistema operacional Windows.

Nome

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Substituir ("Nome"), MappingStrings ("Win32API|Estruturas de gerenciamento de rede|nome")

Nome da conta de usuário do Windows no domínio especificado pela propriedade Domain dessa classe.

Exemplo: "danwilson".

Essa propriedade é herdada de CIM_ManagedSystemElement.

PasswordChangeable

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Qualificadores: MappingStrings ("Win32API|Estruturas de gerenciamento de rede|USER_INFO_2|UF_PASSWD_CANT_CHANGE")

Se true, a senha nessa conta de usuário pode ser alterada.

PasswordExpires

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Qualificadores: MappingStrings ("Win32API|Estruturas de gerenciamento de rede|USER_INFO_2|UF_DONT_EXPIRE_PASSWD")

Se true, a senha nessa conta de usuário vai expirar.

PasswordRequired

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Qualificadores: MappingStrings ("Win32API|Estruturas de gerenciamento de rede|USER_INFO_2|UF_PASSWD_NOTREQD")

Se true, uma senha é necessária em uma conta de usuário do Windows. Se false, essa conta não exigirá uma senha.

SID

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Fixo,MappingStrings ("Win32API|Identificadores de Segurança (SIDs)")

Identificador de segurança (SID) para esta conta. Um SID é um valor de cadeia de caracteres de comprimento variável que é usado para identificar um administrador. Cada conta tem um SID exclusivo que uma autoridade, como um domínio do Windows, emite. O SID é armazenado em um banco de dados de segurança. Quando um usuário faz logon, o sistema recupera o SID do usuário do banco de dados, coloca o SID no token de acesso do usuário e usa o SID no token de acesso do usuário para identificar o usuário em todas as interações subsequentes com a segurança do Windows. Cada SID é um identificador exclusivo para um usuário ou grupo, e um usuário ou grupo diferente não pode ter o mesmo SID.

Essa propriedade é herdada de Win32_Account.

SIDType

Tipo de dados: uint8

Tipo de acesso: Somente leitura

Qualificadores: Fixo, MappingStrings ("Win32API|Tipos de enumeração de controle de acesso|SID_NAME_USE")

Valor enumerado que especifica o tipo de SID.

Essa propriedade é herdada de Win32_Account.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Status

Tipo de dados: string

Tipo de acesso: Somente leitura

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

Status atual de um objeto. Vários status operacionais e não operacionais podem ser definidos. Os status operacionais incluem: "OK", "Degradado" e "Pred Fail", que é um elemento, como uma unidade de disco rígido habilitada para SMART, que pode funcionar corretamente, mas prevê uma falha em um futuro próximo. Os status não operacionais incluem: "Erro", "Iniciando", "Parando" e "Serviço", que podem ser aplicados durante a recuperação de espelho um disco, o recarregamento de uma lista de permissões de usuário ou outro trabalho administrativo.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Error ("Erro")

Degraded ("Degradado")

Unknown ("Desconhecido")

Pred Fail ("Falha de pred")

Starting ("Iniciando")

Stopping ("Interrompendo")

Service ("Serviço")

Stressed ("Estressado")

NonRecover ("NonRecover")

No Contact ("Sem contato")

Lost Comm ("Comunicação perdida")

Comentários

A classe Win32_UserAccount é derivada de Win32_Account.

Observação

Um erro não será retornado para uma tentativa de gravação em uma propriedade somente leitura e o valor da propriedade permanecerá inalterado.

 

Exemplos

O exemplo de código VBScript a seguir mostra como obter o nome completo de um usuário em um computador local. O nome completo é o nome da linguagem humana, por exemplo, uma pessoa pode ter o nome de usuário de "kensanchez" e o nome completo pode ser "Ken Sanchez", portanto, você substitui o nome de domínio real e o nome de usuário por "MyDomainName" e "MyUserName". Para uma consulta eficiente, você deve especificar as propriedades de domínio e nome de usuário.

Se você for um administrador em um computador remoto, poderá atribuir o nome do computador remoto para strComputer (em vez de ".") e, em seguida, usar o seguinte tipo de script para obter o nome completo de uma conta de usuário em um computador local — de um computador 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 com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

Win32_Account

Classes do sistema operacional