Compartilhar via


classe Win32_NetworkLoginProfile

A classe WMIWin32_NetworkLoginProfile representa as informações de logon de rede de um usuário específico em um sistema de computador que executa o Windows. Isso inclui, mas não se limita a status de senha, privilégios de acesso, cotas de disco e caminhos de diretório de logon.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas.

Sintaxe

[Dynamic, Provider("CIMWin32"), Privileges("SeRestorePrivilege"), UUID("{8502C4E7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkLoginProfile : CIM_Setting
{
  string   Caption;
  string   Description;
  string   SettingID;
  datetime AccountExpires;
  uint32   AuthorizationFlags;
  uint32   BadPasswordCount;
  uint32   CodePage;
  string   Comment;
  uint32   CountryCode;
  uint32   Flags;
  string   FullName;
  string   HomeDirectory;
  string   HomeDirectoryDrive;
  datetime LastLogoff;
  datetime LastLogon;
  string   LogonHours;
  string   LogonServer;
  uint64   MaximumStorage;
  string   Name;
  uint32   NumberOfLogons;
  string   Parameters;
  datetime PasswordAge;
  datetime PasswordExpires;
  uint32   PrimaryGroupId;
  uint32   Privileges;
  string   Profile;
  string   ScriptPath;
  uint32   UnitsPerWeek;
  string   UserComment;
  uint32   UserId;
  string   UserType;
  string   Workstations;
};

Membros

A classe Win32_NetworkLoginProfile tem estes tipos de membros:

Propriedades

A classe Win32_NetworkLoginProfile tem essas propriedades.

AccountExpires

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_acct_expires")

A conta expirará. Esse valor é calculado a partir do número de segundos decorridos desde 00:00:00, 1º de janeiro de 1970 e é definido nesse formato: yyyymmddhhmmss.mmmmmm sutc.

Exemplo: 20521201000230.00000000 000

AuthorizationFlags

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_auth_flags"), BitValues ("Printer", "Communication", "Server", "Accounts")

Conjunto de sinalizadores que especificam os recursos que um usuário está autorizado a usar ou modificar.

1 (0x1)

Impressora

2 (0x2)

Comunicação

4 (0x4)

Servidor

8 (0x8)

Contas

BadPasswordCount

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções de gerenciamento de rede| NetUserEnum")

Número de vezes que o usuário insere uma senha incorreta ao fazer logon em um sistema de computador que executa o Windows.

Exemplo: 0

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64)

Descrição textual curta do objeto atual.

Essa propriedade é herdada de CIM_Setting.

CodePage

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_code_page")

Página de código para o idioma de escolha do usuário. Uma página de código é o conjunto de caracteres usado.

Comentário

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_comment")

Comentário ou descrição para este perfil de logon.

CountryCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_country_code")

Código de país/região para o idioma de escolha do usuário.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição textual do objeto atual.

Essa propriedade é herdada de CIM_Setting.

Sinalizadores

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_flags"), BitMap ("0", "1", "3", "4", "5", "6", "7", "8", "9", "11", "12", "13", "16", "17", "18", "19", "20", "21", "22", "23"), BitValues ("Script", "Conta Desabilitada", "Dir Inicial Obrigatório", "Bloqueio", "Senha Não Necessária", "Paswword Não Pode Alterar", "Senha de Teste Criptografada Permitida", "Conta Duplicada Temporária", "Conta Normal", "Conta De Confiança interDomínio", "Conta de Confiança da Estação de Trabalho", "Conta de Confiança do Servidor", "Não expirar senha", "Conta de logon MNS", "Cartão inteligente necessário", "Confiável para delegação", "Não delegado", "Usar somente chave DES", "Não exigir pré-autorização", "Senha expirada")

As propriedades disponíveis para esse perfil de rede.

As propriedades que podem ser definidas incluem:

1 (0x1)

Script

Um script de logon executado. Esse valor deve ser definido para o LAN Manager 2.0.

2 (0x2)

Conta Desabilitada

A conta do usuário está desabilitada.

8 (0x8)

Diretório Inicial Obrigatório

Um diretório base é necessário.

16 (0x10)

Bloquear

No momento, a conta está bloqueada. Para NetUserSetInfo, esse valor pode ser limpo para desbloquear uma conta bloqueada anteriormente. Esse valor não pode ser usado para bloquear uma conta desbloqueada anteriormente.

32 (0x20)

Senha não necessária

Nenhuma senha é necessária.

64 (0x40)

Senha não pode ser alterada

O usuário não pode alterar a senha.

128 (0x80)

Senha de teste criptografada permitida

256 (0x100)

Conta duplicada temporária

Uma conta para usuários cuja conta primária está em outro domínio. Essa conta fornece acesso do usuário a esse domínio, mas não a nenhum domínio que confie nesse domínio. O Gerenciador de Usuários refere-se a esse tipo de conta como uma conta de usuário local.

512 (0x200)

Conta Normal

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

2048 (0x800)

Conta de confiança de interdomínio

Uma permissão para uma conta de confiança para um domínio que confia em outros domínios.

4096 (0x1000)

Conta de confiança da estação de trabalho

Uma conta de computador para uma estação de trabalho do Windows ou servidor que é membro deste domínio.

8192 (0x2000)

Conta de Confiança do Servidor

Uma conta de computador para um controlador de domínio de backup que é membro desse domínio.

65536 (0x10000)

Não Expirar Senha

131072 (0x20000)

Conta de Logon do MNS

Tipo de conta de logon MNS (Conjunto de Nós Majoritários) que representa um usuário MNS.

262144 (0x40000)

Cartão inteligente obrigatório

524288 (0x80000)

Confiável para Delegação

1048576 (0x100000)

Não delegado

2097152 (0x200000)

Usar somente a chave DES

4194304 (0x400000)

Não exigir pré-autorização

8388608 (0x800000)

Senha expirada

Indica que a senha expirou.

As propriedades a seguir descrevem o tipo de conta. Somente um valor pode ser definido:

  • UF_NORMAL_ACCOUNT
  • UF_TEMP_DUPLICATE_ACCOUNT
  • UF_WORKSTATION_TRUST_ACCOUNT
  • UF_SERVER_TRUST_ACCOUNT
  • UF_INTERDOMAIN_TRUST_ACCOUNT

FullName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_full_name")

Nome completo do usuário que pertence ao perfil de logon de rede. Essa cadeia de caracteres pode estar vazia se o usuário optar por não associar um nome completo a um nome de usuário.

HomeDirectory

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_home_dir")

Caminho para o diretório base do usuário. Essa cadeia de caracteres poderá estar vazia se o usuário optar por não especificar um diretório base.

Exemplo:"\HOMEDIR"

HomeDirectoryDrive

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_home_dir_drive")

Letra da unidade atribuída ao diretório base do usuário para fins de logon.

Exemplo: "C:"

LastLogoff

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_last_logoff")

O usuário fez logon pela última vez no sistema. Esse valor é calculado com base no número de segundos decorridos desde 00:00:00, 1º de janeiro de 1970. Um valor de " ***********.*** significa que a hora do último logoff é desconhecida. O formato desse valor é yyyymmddhhmmss.mmmmmmmm sutc. Para obter informações sobre como converter essa propriedade em sua hora local, consulte Tarefas do WMI: datas e horas.

Exemplo: 19521201000230.000000 000

LastLogon

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_last_logon")

O usuário fez logon pela última vez no sistema. Esse valor é calculado com base no número de segundos decorridos desde 00:00:00, 1º de janeiro de 1970. O formato desse valor é yyyymmddhhmmss.mmmmmmmm sutc. Para obter informações sobre como converter essa propriedade em sua hora local, consulte Tarefas do WMI: datas e horas.

Exemplo: 19521201000230.000000 000

LogonHours

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (147), MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_logon_hours")

Horários durante a semana em que o usuário pode fazer logon. Cada bit representa uma unidade de tempo especificada pela propriedade UnitsPerWeek . Por exemplo, se a unidade de tempo for por hora, o primeiro bit (bit 0, palavra 0) será domingo, 0:00 a 0:59, o segundo bit (bit 1, palavra 0) será domingo, 1:00 a 1:59 e assim por diante. Se esse membro estiver definido como NULL, não haverá restrição de tempo. A hora é definida como GMT e deve ser ajustada para outros fusos horários (por exemplo, GMT menos 8 horas para PST).

LogonServer

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_logon_server")

Nome do servidor para o qual as solicitações de logon são enviadas. Os nomes de servidor devem ser precedidos por duas barras invertidas (\\). Um nome de servidor com um asterisco (\\*) indica que a solicitação de logon pode ser manipulada por qualquer servidor de logon. Uma cadeia de caracteres nula indica que as solicitações são enviadas ao controlador de domínio.

Exemplo: "\\MyServer"

MaximumStorage

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_max_storage"), Unidades ("bytes")

Quantidade máxima de espaço em disco disponível para o usuário. Se MaximumStorage estiver definido como USER_MAXSTORAGE_UNLIMITED, o usuário poderá usar todo o espaço em disco disponível.

Exemplo: 10000000

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: key, MaxLen (256), MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_name")

Conta de usuário em um domínio ou computador específico. O número de caracteres no nome não pode exceder o valor de UNLEN.

Exemplo: "somedomain\johndoe"

NumberOfLogons

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_num_logons")

Número de vezes bem-sucedidas que o usuário tentou fazer logon nessa conta. Um valor de 0xFFFFFFFF indica que o valor é desconhecido. Essa propriedade é mantida separadamente em cada BDC (controlador de domínio de backup) no domínio. Para obter um valor preciso, somente o maior valor de todos os BDCs deve ser usado.

Exemplo: 4

Parâmetros

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_parms")

Espaço reservado para uso por aplicativos. Essa cadeia de caracteres pode ser nula ou pode ter qualquer número de caracteres antes do caractere nulo de terminação. Os produtos da Microsoft usam esse membro para armazenar informações de configuração do usuário. Não modifique essas informações, pois esse valor é específico para um aplicativo.

PasswordAge

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_password_age")

Período de tempo em que uma senha está em vigor. Esse valor é medido a partir do número de segundos decorridos desde que a senha foi alterada pela última vez.

Exemplo: 00001201000230.0000000 000

PasswordExpires

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_MODALS_INFO_0|usrmod0_max_passwd_age")

Data e hora em que a senha expira. O valor é definido neste formato: yyyymmddhhmmss.mmmmmm sutc

Exemplo: 19521201000230.00000000 000

PrimaryGroupId

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_primary_group_id")

Rid (identificador relativo) do Grupo Global Primário para esse usuário. O identificador verifica o grupo primário ao qual o perfil do usuário pertence.

Privilégios

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_priv")

Nível de privilégio atribuído à propriedade usri3_name .

Convidado (0)

Usuário (1)

Administrador (2)

Perfil

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_profile")

Caminho para o perfil do usuário. Esse valor pode ser uma cadeia de caracteres nula, um caminho absoluto local ou um caminho UNC. Um perfil de usuário contém configurações personalizáveis para cada usuário, como as cores da área de trabalho.

Exemplo: "C:\Windows"

Scriptpath

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_script_path")

Caminho do diretório para o script de logon do usuário. Um script de logon executa automaticamente um conjunto de comandos sempre que um usuário faz logon em um sistema.

Exemplo: "C:\win\profiles\ThomasSteven"

Settingid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (256)

Identificador pelo qual o objeto atual é conhecido.

Essa propriedade é herdada de CIM_Setting.

UnitsPerWeek

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_units_per_week")

Número de unidades de tempo em que a semana é dividida. Ele é usado com a propriedade LogonHours para limitar o acesso do usuário ao computador.

Exemplo: 168 (horas por semana)

UserComment

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_usr_comment")

Comentário ou descrição definido pelo usuário para este perfil.

UserId

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_user_id")

RID do usuário. O identificador verifica se o usuário existe e é exclusivo para esse domínio.

UserType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_flags")

Tipo de conta para a qual o usuário tem privilégios.

Os valores são:

  • "Conta Normal"
  • "Conta duplicada"
  • "Conta de Confiança da Estação de Trabalho"
  • "Conta de Confiança do Servidor"
  • "Conta de Confiança interdomínio"
  • "Desconhecido"

Conta Normal ("Conta Normal")

Conta duplicada ("Conta duplicada")

Conta de Confiança da Estação de Trabalho ("Conta de Confiança da Estação de Trabalho")

Conta de Confiança do Servidor ("Conta de Confiança do Servidor")

Conta fiduciário interdomínio ("Conta De confiança interdomínio")

Desconhecido ("Desconhecido")

Estações

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| USER_INFO_3|usri3_workstations")

Nomes de estações de trabalho das quais o usuário pode fazer logon. Até oito estações de trabalho podem ser especificadas; os nomes devem ser separados por vírgulas (,). Uma cadeia de caracteres nula indica nenhuma restrição. Para desabilitar logons de todas as estações de trabalho para essa conta, defina o UF_ACCOUNTDISABLE na propriedade Flags dessa classe.

Comentários

A classe Win32_NetworkLoginProfile é derivada de CIM_Setting.

O processo de chamada que usa essa classe deve ter o privilégio SE_RESTORE_NAME no computador no qual o registro reside. Para obter mais informações, consulte Executando operações privilegiadas.

Exemplos

O exemplo Listar Perfis de Logon de Rede do PowerShell retorna informações de logon de rede para todos os usuários de um computador.

O exemplo de VBScript a seguir retorna informações de logon de rede.

On Error Resume Next 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set colItems = objWMIService.ExecQuery _ 
    ("Select * from Win32_NetworkLoginProfile") 
 
For Each objItem in colItems 
    dtmWMIDate = objItem.AccountExpires 
    strReturn = WMIDateStringToDate(dtmWMIDate) 
    Wscript.Echo "Account Expires: " & strReturn 
    Wscript.Echo "Authorization Flags: " & objItem.AuthorizationFlags 
    Wscript.Echo "Bad Password Count: " & objItem.BadPasswordCount 
    Wscript.Echo "Caption: " & objItem.Caption 
    Wscript.Echo "CodePage: " & objItem.CodePage 
    Wscript.Echo "Comment: " & objItem.Comment 
    Wscript.Echo "Country Code: " & objItem.CountryCode 
    Wscript.Echo "Description: " & objItem.Description 
    Wscript.Echo "Flags: " & objItem.Flags 
    Wscript.Echo "Full Name: " & objItem.FullName 
    Wscript.Echo "Home Directory: " & objItem.HomeDirectory 
    Wscript.Echo "Home Directory Drive: " & objItem.HomeDirectoryDrive 
    dtmWMIDate = objItem.LastLogoff 
    strReturn = WMIDateStringToDate(dtmWMIDate) 
    Wscript.Echo "Last Logoff: " & strReturn 
    dtmWMIDate = objItem.LastLogon 
    strReturn = WMIDateStringToDate(dtmWMIDate) 
    Wscript.Echo "Last Logon: " & strReturn 
    Wscript.Echo "Logon Hours: " & objItem.LogonHours 
    Wscript.Echo "Logon Server: " & objItem.LogonServer 
    Wscript.Echo "Maximum Storage: " & objItem.MaximumStorage 
    Wscript.Echo "Name: " & objItem.Name 
    Wscript.Echo "Number Of Logons: " & objItem.NumberOfLogons 
    Wscript.Echo "Password Age: " & objItem.PasswordAge 
    dtmWMIDate = objItem.PasswordExpires 
    strReturn = WMIDateStringToDate(dtmWMIDate) 
    Wscript.Echo "Password Expires: " & strReturn 
    Wscript.Echo "Primary Group ID: " & objItem.PrimaryGroupId 
    Wscript.Echo "Privileges: " & objItem.Privileges 
    Wscript.Echo "Profile: " & objItem.Profile 
    Wscript.Echo "Script Path: " & objItem.ScriptPath 
    Wscript.Echo "Setting ID: " & objItem.SettingID 
    Wscript.Echo "Units Per Week: " & objItem.UnitsPerWeek 
    Wscript.Echo "User Comment: " & objItem.UserComment 
    Wscript.Echo "User Id: " & objItem.UserId 
    Wscript.Echo "User Type: " & objItem.UserType 
    Wscript.Echo "Workstations: " & objItem.Workstations 
    Wscript.Echo 
Next 
  
Function WMIDateStringToDate(dtmWMIDate) 
    If Not IsNull(dtmWMIDate) Then 
    WMIDateStringToDate = CDate(Mid(dtmWMIDate, 5, 2) & "/" & _ 
         Mid(dtmWMIDate, 7, 2) & "/" & Left(dtmWMIDate, 4) _ 
             & " " & Mid (dtmWMIDate, 9, 2) & ":" & _ 
                 Mid(dtmWMIDate, 11, 2) & ":" & Mid(dtmWMIDate, 13, 2)) 
    End If 
End Function 

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_Setting

Classes do sistema operacional