{"id":810196,"date":"2026-05-20T14:08:59","date_gmt":"2026-05-20T14:08:59","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=810196"},"modified":"2026-05-20T14:08:59","modified_gmt":"2026-05-20T14:08:59","slug":"como-fazer-o-logout-remoto-de-usuarios-no-windows-com-o-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/pt-br\/script-hub\/como-fazer-o-logout-remoto-de-usuarios-no-windows-com-o-powershell\/","title":{"rendered":"Como fazer o logoff remoto de usu\u00e1rios no Windows com o PowerShell"},"content":{"rendered":"

No cen\u00e1rio moderno de TI, o gerenciamento de sess\u00f5es de usu\u00e1rios \u00e9 fundamental. Seja para garantir que as sess\u00f5es n\u00e3o utilizadas n\u00e3o consumam recursos ou para manter os protocolos de seguran\u00e7a, garantindo que as sess\u00f5es n\u00e3o autorizadas sejam encerradas, \u00e9 necess\u00e1rio um gerenciamento eficiente das sess\u00f5es. Essa import\u00e2ncia \u00e9 enfatizada quando consideramos o aumento do trabalho remoto e as v\u00e1rias sess\u00f5es iniciadas em v\u00e1rios locais. O PowerShell<\/a>, com sua versatilidade, oferece uma excelente solu\u00e7\u00e3o para esse desafio por meio deste script que far\u00e1 o logoff remoto dos usu\u00e1rios<\/strong><\/p>\n

Hist\u00f3rico<\/h2>\n

O script fornecido tem uma finalidade simples, mas crucial: fazer logoff de usu\u00e1rios especificados de uma m\u00e1quina Windows, com exce\u00e7\u00e3o da sess\u00e3o do console. Embora muitos profissionais de TI e provedores de servi\u00e7os gerenciados (MSPs)<\/a> possam se perguntar sobre sua utilidade, dada a disponibilidade de ferramentas baseadas em GUI, lembre-se de que as solu\u00e7\u00f5es automatizadas e dimension\u00e1veis geralmente exigem abordagens baseadas em scripts. Esse script permite que os administradores integrem perfeitamente os recursos de logout do usu\u00e1rio em fluxos de trabalho de automa\u00e7\u00e3o maiores, o que \u00e9 crucial para empresas com v\u00e1rias sess\u00f5es de usu\u00e1rio para gerenciar.<\/p>\n

O roteiro<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Logs off user(s) specified. You can't log off a user from the console session.\r\n.DESCRIPTION\r\n    Logs off user(s) specified. You can't log off a user from the console session.\r\n.EXAMPLE\r\n     -User \"Administrator\"\r\n    Logs off Administrator user.\r\n.EXAMPLE\r\n     -User \"Administrator\",\"Guest\"\r\n    Logs off Administrator and Guest users.\r\n.EXAMPLE\r\n    PS C:> Logoff-User.ps1 -User \"Administrator\",\"Guest\"\r\n    Logs off Administrator and Guest users.\r\n.OUTPUTS\r\n    String[]\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes:\r\n    Initial Release\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(SupportsShouldProcess = $True)]\r\nparam (\r\n    # User name(s) to log off\r\n    [Parameter(Mandatory = $true)]\r\n    [String[]]\r\n    $User\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        # 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        $Header = $($Lines[0].split(',').trim())\r\n        for ($i = 1; $i -lt $($Lines.Count); $i++) {\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            $CurUser = [PSCustomObject]::new()\r\n            for ($j = 0; $j -lt $($Line.count); $j++) {\r\n                $CurUser | Add-Member -MemberType NoteProperty -Name $Header[$j] -Value $Line[$j]\r\n            }\r\n            $CurUser\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 a list of users logged on from query.exe, format it for powershell to process\r\n    $QueryResults = Get-QueryUser\r\n    # Accounts for only one user logged in\r\n    $QueryTest = $($QueryResults | Select-Object -First 1)\r\n    if (\r\n        $QueryResults.Count -or\r\n        (\r\n            $QueryTest.USERNAME -is [String] -and\r\n            -not [String]::IsNullOrEmpty($QueryTest.USERNAME) -and\r\n            -not [String]::IsNullOrWhiteSpace($QueryTest.USERNAME)\r\n        )\r\n    ) {\r\n        $script:HasError = $false\r\n        $QueryResults | Where-Object {\r\n    \r\n            # For each session filter out the user that weren't specified in $User\r\n            $_.UserName -in $User\r\n    \r\n        } | ForEach-Object {\r\n            Write-Host \"Found Logged In User: $($_.UserName)\"\r\n            if ($_.SessionName -like \"console\") {\r\n                # We can't log out a user that is at the console.\r\n                # We could do this logic in the Where-Object code block, but then there isn't an output of what was skipped.\r\n                # https:\/\/docs.microsoft.com\/en-us\/windows-server\/administration\/windows-commands\/logoff#remarks\r\n                # \"You can't log off a user from the console session.\"\r\n                Write-Host \"Skipping user, can't log off a user($($_.UserName)) from the $($_.SessionName) session.\"\r\n            }\r\n            else {\r\n                # Log off the user session with a matching ID\r\n                logoff.exe $_.Id\r\n                if ($LASTEXITCODE -gt 0) {\r\n                    $script:HasError = $true\r\n                    Write-Error \"logoff.exe $($_.Id) returned exit code: $LASTEXITCODE\"\r\n                }\r\n                else {\r\n                    Write-Host \"Logged Off User: $($_.UserName)\"\r\n                }\r\n            }\r\n        }\r\n        if ($script:HasError) {\r\n            exit 1\r\n        }\r\n    }\r\n    else {\r\n        Write-Output \"No Users Logged In\"\r\n        exit 2\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