{"id":809717,"date":"2026-05-19T09:02:32","date_gmt":"2026-05-19T09:02:32","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=809717"},"modified":"2026-05-19T09:02:32","modified_gmt":"2026-05-19T09:02:32","slug":"view-user-login-history-with-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/pt-br\/script-hub\/view-user-login-history-with-powershell\/","title":{"rendered":"Desvendando o hist\u00f3rico de login do usu\u00e1rio com o PowerShell"},"content":{"rendered":"

Os scripts do PowerShell desempenham um papel inestim\u00e1vel nas opera\u00e7\u00f5es e na seguran\u00e7a de TI, automatizando tarefas e extraindo informa\u00e7\u00f5es vitais para an\u00e1lise. Hoje, vamos nos aprofundar em um script que permite visualizar o hist\u00f3rico de login do usu\u00e1rio,<\/strong> uma fun\u00e7\u00e3o importante para auditar e monitorar o acesso ao sistema.<\/p>\n

Hist\u00f3rico<\/h2>\n

Os registros de acesso s\u00e3o uma mina de ouro para os profissionais de TI. Eles ajudam a monitorar o uso do sistema, detectar acesso n\u00e3o autorizado e manter a responsabilidade. O script fornecido obt\u00e9m eventos de in\u00edcio e parada de sess\u00e3o do usu\u00e1rio, um conjunto de dados essencial para qualquer estrat\u00e9gia robusta de seguran\u00e7a de TI. Ao excluir as contas do sistema e concentrar-se apenas nos usu\u00e1rios genu\u00ednos, ele apresenta um hist\u00f3rico limpo e conciso do acesso do usu\u00e1rio, tornando a vida dos profissionais de TI e dos provedores de servi\u00e7os gerenciados (MSPs)<\/a> mais simples e eficiente.<\/p>\n

O roteiro<\/h2>\n

Email me the script<\/a><\/div>
\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    This will return user session start and stop events.\r\n.DESCRIPTION\r\n    This will return user session start and stop events. Excluding system accounts.\r\n.EXAMPLE\r\n    No params needed\r\n    Returns all login events for all users.\r\n.EXAMPLE\r\n     -UserName \"Fred\"\r\n    Returns all user login events of the user Fred.\r\n.EXAMPLE\r\n     -Days 7\r\n    Returns the last 7 days of login events for all users.\r\n.EXAMPLE\r\n     -Days 7 -UserName \"Fred\"\r\n    Returns the last 7 days of login events for the user Fred.\r\n.EXAMPLE\r\n    PS C:> Get-User-Login-History.ps1 -Days 7 -UserName \"Fred\"\r\n    Returns the last 7 days of login events for the user Fred.\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes:\r\n    Initial Release\r\n.OUTPUTS\r\n    Time                  Event        User  ID\r\n    ----                  -----        ----  --\r\n    10\/7\/2021 3:51:48 PM  SessionStop  User1 4634\r\n    10\/7\/2021 3:51:48 PM  SessionStart User1 4624\r\n.COMPONENT\r\n    ManageUsers\r\nBy using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https:\/\/www.ninjaone.com\/terms-of-use.\r\n    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. \r\n    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. \r\n    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. \r\n    Warranty Disclaimer: The script is provided \u201cas is\u201d and \u201cas available\u201d, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. \r\n    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. \r\n    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. \r\n    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    # Specify one user\r\n    [Parameter(Mandatory = $false)]\r\n    [String]\r\n    $UserName,\r\n    # How far back in days you want to search, this is in 24 hour increments from the time it executes\r\n    [Parameter(Mandatory = $false)]\r\n    [int]\r\n    $Days\r\n)\r\n\r\nbegin {\r\n    function Test-IsElevated {\r\n        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()\r\n        $p = New-Object System.Security.Principal.WindowsPrincipal($id)\r\n        if ($p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator))\r\n        { Write-Output $true }\r\n        else\r\n        { Write-Output $false }\r\n    }\r\n\r\n    # System accounts that we don't want\r\n    $SystemUsers = @(\r\n        \"SYSTEM\"\r\n        \"NETWORK SERVICE\"\r\n        \"LOCAL SERVICE\"\r\n    )\r\n    # Filter for only getting session start and stop events from Security event log\r\n    $FilterHashtable = @{\r\n        LogName = \"Security\";\r\n        id      = 4634, 4624\r\n    }\r\n    # If Days was specified then add this parameter\r\n    if ($Days) {\r\n        $FilterHashtable.Add(\"EndTime\", (Get-Date).AddDays(-$Days))\r\n    }\r\n    # Creating a hash table for parameter splatting\r\n    $Splat = @{\r\n        FilterHashtable = $FilterHashtable\r\n    }\r\n}\r\n\r\nprocess {\r\n    if (-not (Test-IsElevated)) {\r\n        Write-Error -Message \"Access Denied. Please run with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n    # Get windows events, filter out everything but logins and logouts(Session starts and ends)\r\n    Get-WinEvent @Splat | ForEach-Object {\r\n        # UserName in the two event types are in different places in the Properties array\r\n        if ($_.Id -eq 4634) {\r\n            # Events with ID 4634 the user name is the second item in the array. Arrays start at 0 in PowerShell.\r\n            $User = $_.Properties[1].Value\r\n        }\r\n        else {\r\n            # Events with ID 4634 the user name is the sixth item in the array. Arrays start at 0 in PowerShell.\r\n            $User = $_.Properties[5].Value\r\n        }\r\n\r\n        # Filter out system accounts and computer logins(Active Directory related)\r\n        # DWM-0  = Desktop Window Manager\r\n        # UMFD-0 = User Mode Framework Driver\r\n        if ($SystemUsers -notcontains $User -and $User -notlike \"DWM-*\" -and $User -notlike \"UMFD-*\" -and $User -notlike \"*$\") {\r\n            # If the UserName parameter was specified then only return that user's events\r\n            if ($UserName -and $UserName -like $User) {\r\n                # Write out to StandardOutput\r\n                [PSCustomObject]@{\r\n                    Time  = $_.TimeCreated\r\n                    Event = if ($_.Id -eq 4634) { \"SessionStop\" } else { \"SessionStart\" }\r\n                    User  = $User\r\n                    ID    = $_.ID\r\n                }\r\n            } # If the UserName parameter was not specified return all users events\r\n            elseif (-not $UserName) {\r\n                # Write out to StandardOutput\r\n                [PSCustomObject]@{\r\n                    Time  = $_.TimeCreated\r\n                    Event = if ($_.Id -eq 4634) { \"SessionStop\" } else { \"SessionStart\" }\r\n                    User  = $User\r\n                    ID    = $_.ID\r\n                }\r\n            }\r\n        }\r\n        # Null $User just in case the next loop iteration doesn't set it, we can then see that the user name is missing\r\n        $User = $null\r\n    }\r\n}\r\n\r\nend {}\r\n<\/pre>\n
 <\/p>\n
Acesse mais de 300 scripts no NinjaOne Dojo<\/p>\n
Obter acesso<\/a><\/p>\n<\/div><\/p>\n
Detalhamento<\/h2>\n