Classe Win32_UserAccount
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 |
|
| DLL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de