{"id":809718,"date":"2026-05-19T09:03:22","date_gmt":"2026-05-19T09:03:22","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=809718"},"modified":"2026-05-19T09:03:22","modified_gmt":"2026-05-19T09:03:22","slug":"como-detectar-o-tempo-ocioso-do-usuario-usando-o-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/pt-br\/script-hub\/como-detectar-o-tempo-ocioso-do-usuario-usando-o-powershell\/","title":{"rendered":"Como detectar o tempo ocioso do usu\u00e1rio usando o PowerShell"},"content":{"rendered":"

A detec\u00e7\u00e3o de tempo ocioso em computadores tem sido um aspecto cr\u00edtico para os profissionais de TI, especialmente na era das crescentes amea\u00e7as \u00e0 seguran\u00e7a cibern\u00e9tica<\/a> e ao gerenciamento de recursos. \u00c0 medida que as organiza\u00e7\u00f5es se digitalizam rapidamente e os usu\u00e1rios permanecem conectados por longos per\u00edodos, a detec\u00e7\u00e3o do tempo ocioso do usu\u00e1rio<\/strong> torna-se fundamental por motivos operacionais e de seguran\u00e7a. Nesta postagem, vamos nos aprofundar em um script do PowerShell desenvolvido para detectar o maior tempo ocioso dos usu\u00e1rios, tornando a tarefa perfeita e eficiente.<\/p>\n

Hist\u00f3rico<\/h2>\n

A capacidade de determinar h\u00e1 quanto tempo um usu\u00e1rio est\u00e1 inativo pode fornecer informa\u00e7\u00f5es valiosas para profissionais de TI e provedores de servi\u00e7os gerenciados (MSPs)<\/a>. Seja para liberar recursos, garantir que as sess\u00f5es n\u00e3o permane\u00e7am abertas a poss\u00edveis amea\u00e7as \u00e0 seguran\u00e7a ou at\u00e9 mesmo considera\u00e7\u00f5es de faturamento para provedores de servi\u00e7os em nuvem<\/a>, \u00e9 essencial ter um m\u00e9todo eficaz e confi\u00e1vel para determinar a inatividade do usu\u00e1rio. Esse script espec\u00edfico aproveita a capacidade do PowerShell de interagir diretamente com o sistema operacional Windows e extrair dados relevantes para medir os tempos de inatividade.<\/p>\n

O roteiro<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Returns the longest idle time of any user logged in or for a specific user.\r\n.DESCRIPTION\r\n    Returns the longest idle time of any user logged in or for a specific user.\r\n    If RDS(Remote Desktop Services) is installed and the RSAT tools for it as well,\r\n     then this will get the idle time of each logged in user.\r\n    For workstations and servers(with out RDS installed),\r\n     this will get the current idle of the currently logged in user.\r\n    If a user is logged in via the console and another is via the admin RDP session,\r\n     then both will be considered as one user for calculating idle time.\r\n.EXAMPLE\r\n    No parameters needed.\r\n    Returns the longest idle time of all users logged in.\r\n.EXAMPLE\r\n     -UserName \"Fred\"\r\n    Returns the longest idle time of the user Fred.\r\n.EXAMPLE\r\n    PS C:> Get-User-Idle-Time.ps1 -UserName \"Fred\"\r\n    Returns the longest idle time of the user Fred.\r\n.OUTPUTS\r\n    PSCustomObject[]\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes:\r\n    Adds functions to get idle time from RDS and non-RDS computers.\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.COMPONENT\r\n    ManageUsers\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    # Specify one user on a Terminal Services Server, else leave blank for normal servers and workstations\r\n    [Parameter(Mandatory = $false)]\r\n    $UserName\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    Function Get-QueryUser() {\r\n        Param()\r\n        $Result = @()\r\n        # Replaces all occurrences of 2 or more spaces in a row with a single comma\r\n        $Lines = @(query.exe user).foreach({ $(($_) -replace ('s{2,}', ',')) })\r\n        if ($Lines.Count -gt 1) {\r\n            $Header = $($Lines[0].split(',').trim())\r\n            for ($i = 1; $i -lt $($Lines.Count); $i++) {\r\n                $Res = \"\" | Select-Object $Header\r\n                $Line = $($Lines[$i].split(',')).foreach({ $_.trim().trim('>') })\r\n                # Accounts for disconnected users\r\n                if ($Line.count -eq 5) {\r\n                    $Line = @($Line[0], \"$($null)\", $Line[1], $Line[2], $Line[3], $Line[4] )\r\n                }\r\n                for ($j = 0; $j -lt $($Line.count); $j++) {\r\n                    $Res.$($Header[$j]) = $Line[$j]\r\n                }\r\n                $Result += $Res\r\n                Remove-Variable Res\r\n            }\r\n            return $Result\r\n        }\r\n        else {\r\n            return $null\r\n        }\r\n    }\r\n\r\n    Add-Type @\"\r\nusing System;\r\nusing System.Runtime.InteropServices;\r\nusing System.ComponentModel;\r\n\r\nnamespace GetLastUserInput\r\n{\r\n    public class GetLastUserInput\r\n    {\r\n        private struct LASTINPUTINFO\r\n        {\r\n            public uint cbSize;\r\n            public uint dwTime;\r\n        }\r\n        private static LASTINPUTINFO lastInPutNfo;\r\n        static GetLastUserInput()\r\n        {\r\n            lastInPutNfo = new LASTINPUTINFO();\r\n            lastInPutNfo.cbSize = (uint)Marshal.SizeOf(lastInPutNfo);\r\n        }\r\n        [DllImport(\"User32.dll\")]\r\n        private static extern bool GetLastInputInfo(ref LASTINPUTINFO plii);\r\n\r\n        \/\/\/ <summary>\r\n        \/\/\/ Idle time in ticks\r\n        \/\/\/ <\/summary>\r\n        \/\/\/ <returns><\/returns>\r\n        public static uint GetIdleTickCount()\r\n        {\r\n            return ((uint)Environment.TickCount - GetLastInputTime());\r\n        }\r\n        \/\/\/ <summary>\r\n        \/\/\/ Last input time in ticks\r\n        \/\/\/ <\/summary>\r\n        \/\/\/ <returns><\/returns>\r\n        public static uint GetLastInputTime()\r\n        {\r\n            if (!GetLastInputInfo(ref lastInPutNfo))\r\n            {\r\n                throw new Win32Exception(Marshal.GetLastWin32Error());\r\n            }\r\n            return lastInPutNfo.dwTime;\r\n        }\r\n    }\r\n}\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    if ($(Get-Module -Name \"RemoteDesktop\") -and $(Get-RDServer -ErrorAction SilentlyContinue)) {\r\n        try {\r\n            $Sessions = Get-RDUserSession\r\n            $Sessions | Select-Object UserName, IdleTime\r\n        }\r\n        catch {\r\n            Write-Warning -Message \"A Remote Desktop Services deployment does not exist on $env:COMPUTERNAME.\"\r\n        }\r\n    }\r\n    else {\r\n        Write-Warning -Message \"Remote Desktop Services is not installed on this computer, Falling back to query user.\"\r\n        $Results = Get-QueryUser\r\n        if ($null -eq $Results) {\r\n            Write-Host \"No user(s) logged in.\"\r\n            exit 0\r\n        }\r\n        # Parse query results and loop through each user\r\n        $Results | ForEach-Object {\r\n            $CurrentUser = $_.USERNAME\r\n            # If UserName param is used, only filter that user; If UserName param isn't used, return all users\r\n            if ($CurrentUser -like $UserName -or ([string]::IsNullOrEmpty($UserName) -or [string]::IsNullOrWhiteSpace($UserName))) {\r\n                # Output a PowerShell Custom Object array\r\n                [PSCustomObject]@{\r\n                    UserName    = $CurrentUser\r\n                    SessionName = $_.SESSIONNAME\r\n                    Id          = $_.ID\r\n                    State       = $_.STATE\r\n                    LogonTime   = $_.'LOGON TIME'\r\n                    IdleTime    = if ($_.'IDLE TIME' -like 'none') { 0 }else { $_.'IDLE TIME' }\r\n                }\r\n            }\r\n        } | Sort-Object -Property IdleTime | Select-Object -Property UserName, @{\r\n            # Modify IdleTime when it shows none\r\n            Label      = \"IdleTime\"\r\n            Expression = {\r\n                New-TimeSpan -Start $(Get-Date) -End $(Get-Date).AddMilliseconds([GetLastUserInput.GetLastUserInput]::GetIdleTickCount())\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\nend {}<\/pre>\n
 <\/p>\n\n
Acesse mais de 300 scripts no NinjaOne Dojo<\/p>\n
Obter acesso<\/a><\/p>\n<\/div>\n
Detalhamento<\/h2>\n