Compartilhar via


classe Win32_Account

A classe WMI abstrata Win32_Account contém informações sobre contas de usuário e contas de grupo conhecidas pelo sistema de computador que executa o Windows. Nomes de usuário ou grupo reconhecidos por um domínio do Windows são descendentes (ou membros) dessa classe.

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

Sintaxe

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

Membros

A classe Win32_Account tem estes tipos de membros:

Propriedades

A classe Win32_Account tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Descrição curta do objeto.

Essa propriedade é herdada da classe CIM_ManagedSystemElement .

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Descrição do objeto.

Essa propriedade é herdada da classe CIM_ManagedSystemElement .

Domínio

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Nome do domínio do Windows ao qual um grupo ou usuário pertence.

Exemplo: "NA-SALES"

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

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

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

Essa propriedade é herdada da classe CIM_ManagedSystemElement .

LocalAccount

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: Corrigido

Se TRUE, a conta será definida no computador local. Para recuperar somente contas definidas no computador local, crie uma consulta que inclua a condição "LocalAccount=TRUE".

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Substituição ("Nome"), chave, MappingStrings ("Win32API| Estruturas de gerenciamento de rede|nome")

Nome da conta do sistema Windows no domínio especificado pela propriedade Domain dessa classe. Essa propriedade substitui a propriedade Name herdada de CIM_ManagedSystemElement.

SID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

SID (identificador de segurança) para essa conta. Um SID é um valor de cadeia de caracteres de comprimento variável usado para identificar um administrador. Cada conta tem um SID exclusivo emitido por uma autoridade (como um domínio do Windows), 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 e o coloca no token de acesso do usuário. O sistema 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. Quando um SID tiver sido usado como o identificador exclusivo de um usuário ou grupo, ele não poderá ser usado novamente para identificar outro usuário ou grupo.

SIDType

Tipo de dados: uint8

Tipo de acesso: Somente leitura

Qualificadores: Fixed, MappingStrings ("Win32API|Controle de Acesso Tipos de enumeração| SID_NAME_USE")

Valores enumerados que especificam o tipo de SID (identificador de segurança).

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Status atual do objeto. Vários status operacionais e não operacionais podem ser definidos. Os status operacionais incluem: "OK", "Degradado" e "Falha de Pred" (um elemento, como uma unidade de disco rígido habilitada para SMART, pode estar funcionando corretamente, mas prevê uma falha em um futuro próximo). Os status não operacionais incluem: "Erro", "Iniciando", "Parando" e "Serviço". Este último, "Serviço", pode ser aplicado durante espelho resilvering de um disco, recarregamento de uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada da classe CIM_ManagedSystemElement .

Os valores são:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Falha de pred ("Falha de pred")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem contato ("Sem contato")

Comm Perdido ("Comm Perdido")

Comentários

A classe Win32_Account é derivada de CIM_LogicalElement.

Exemplos

O código do PowerShell a seguir recupera as contas locais.

Get-WmiObject Win32_Account -Filter "Domain='$Env:ComputerName'"

O código do PowerShell a seguir recupera as contas de domínio.

 Get-WmiObject Win32_Account -Filter "Domain='$Env:UserDomain'" 

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

CIM_LogicalElement

Classes do sistema operacional