classe Win32_LogonSession
A classe WMI Win32_LogonSession (consulte Recuperando uma classe WMI) descreve a sessão de logon ou as sessões associadas a um usuário conectado a um sistema de computador que executa o Windows.
A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.
Sintaxe
[Dynamic, Provider("CIMWin32"), UUID("{9083C21E-7D58-4e0e-BC30-0BC8922AFB8B}"), AMENDMENT]
class Win32_LogonSession : Win32_Session
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
datetime StartTime;
string AuthenticationPackage;
string LogonId;
uint32 LogonType;
};
Membros
A classe Win32_LogonSession tem estes tipos de membros:
Propriedades
A classe Win32_LogonSession tem essas propriedades.
-
AuthenticationPackage
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Nome do subsistema usado para autenticar a sessão de logon.
-
-
Legenda
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (64), DisplayName ("Caption")
Uma breve descrição textual do objeto .
Essa propriedade é herdada de CIM_ManagedSystemElement.
-
-
Descrição
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Description")
Uma descrição textual do objeto .
Essa propriedade é herdada de CIM_ManagedSystemElement.
-
-
InstallDate
-
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")
Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.
Essa propriedade é herdada de CIM_ManagedSystemElement.
-
-
LogonId
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: chave
ID atribuída à sessão de logon.
-
-
LogonType
-
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Valor numérico que indica o tipo de sessão de logon.
-
-
0
-
Usado apenas pela conta do sistema.
-
Interativo (2)
-
Destinado a usuários que estão usando interativamente o computador, como um usuário sendo conectado por um servidor de terminal, shell remoto ou processo semelhante.
-
Rede (3)
-
Destinado a servidores de alto desempenho para autenticar senhas de texto limpo. LogonUser não armazena credenciais em cache para esse tipo de logon.
-
Lote (4)
-
Destinado a servidores em lote, em que os processos podem ser executados em nome de um usuário sem a intervenção direta; ou para servidores de alto desempenho que processam muitas tentativas de autenticação de texto claro por vez, como servidores Web ou email. LogonUser não armazena credenciais em cache para esse tipo de logon.
-
Serviço (5)
-
Indica um logon de tipo de serviço. A conta fornecida deve ter o privilégio de serviço habilitado.
-
Proxy (6)
-
Indica um logon do tipo proxy.
-
Desbloqueio (7)
-
Esse tipo de logon destina-se aos DLLs gina que fazem logon em usuários que estão usando interativamente o computador. Esse tipo de logon permite gerar um registro de auditoria exclusivo que mostra quando a estação de trabalho foi desbloqueada.
-
NetworkCleartext (8)
-
Preserva o nome e a senha nos pacotes de autenticação, permitindo que o servidor faça conexões com outros servidores de rede enquanto representa o cliente. Isso permite que um servidor aceite credenciais de texto limpas de um cliente, chame LogonUser, verifique se o usuário pode acessar o sistema em toda a rede e ainda se comunicar com outros servidores.
-
NewCredentials (9)
-
Permite que o chamador clone seu token atual e especifique novas credenciais para conexões de saída. A nova sessão de logon tem a mesma identificação local, mas usa credenciais diferentes para outras conexões de rede.
-
RemoteInteractive (10)
-
Sessão de Serviços de Terminal que é remota e interativa.
-
CachedInteractive (11)
-
Tente armazenar credenciais em cache sem acessar a rede.
-
CachedRemoteInteractive (12)
-
O mesmo que RemoteInteractive. Isso é usado para auditoria interna.
-
CachedUnlock (13)
-
Logon da estação de trabalho.
Nome
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Name")
Rótulo pelo qual o objeto é conhecido. Quando subclasse, essa propriedade pode ser substituída para ser uma propriedade de chave.
Essa propriedade é herdada de CIM_ManagedSystemElement.
StartTime
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
Hora em que a sessão foi iniciada.
Essa propriedade é herdada de Win32_Session.
Status
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (10), DisplayName ("Status")
Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. Os status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).
As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando 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 de CIM_ManagedSystemElement.
Os valores incluem o seguinte:
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")
Exemplos
O exemplo Do PowerShell de Informações de Sessão de Logon de Lista retorna informações sobre sessões de logon associadas ao usuário atualmente conectado a um computador.
O exemplo do PowerShell a seguir verifica se há sessão remota aberta para um usuário especificado.
$user = "<user name>"
$servers = gci servers.txt
foreach ($server in $servers){
$logons = gwmi win32_loggedonuser -computername $server
foreach ($logon in $logons){
if ($logon.antecedent -match $user){
$logonid = $logon.dependent.split("=")[1]
$session =gwmi win32_logonsession |? {$_.logonid -match $logonid}
if ($session.logontype -eq "10"){
Write-host "You have an active Terminal Server session on server $($server)"
}
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|