{"id":810195,"date":"2026-05-20T14:08:11","date_gmt":"2026-05-20T14:08:11","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=810195"},"modified":"2026-05-20T14:08:11","modified_gmt":"2026-05-20T14:08:11","slug":"usando-powershell-para-listar-usuarios-locais","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/pt-br\/script-hub\/usando-powershell-para-listar-usuarios-locais\/","title":{"rendered":"Uso do PowerShell para listar usu\u00e1rios locais em sistemas Windows"},"content":{"rendered":"

O PowerShell<\/a> \u00e9 uma ferramenta potente no arsenal dos profissionais de TI, muitas vezes aproveitada por sua capacidade de automatizar tarefas e extrair dados sem problemas. Uma tarefa cr\u00edtica frequentemente encontrada pelos provedores de servi\u00e7os gerenciados (MSPs)<\/a> e administradores de sistemas \u00e9 listar os usu\u00e1rios em um sistema de computador. Hoje, vamos nos aprofundar em um script do PowerShell criado especificamente para isso: listar usu\u00e1rios locais.\u00a0<\/strong><\/p>\n

Hist\u00f3rico<\/h2>\n

N\u00e3o h\u00e1 como negar que, no atual ambiente de TI de ritmo acelerado, a capacidade de extrair rapidamente dados sobre os usu\u00e1rios do sistema \u00e9 inestim\u00e1vel. Isso \u00e9 particularmente verdadeiro em grandes empresas ou sempre que um novo equipamento ou software estiver sendo implementado. Os administradores de sistemas e MSPs geralmente precisam entender quem tem acesso a qu\u00ea e quando. O script do PowerShell fornecido atende a essa necessidade, listando os usu\u00e1rios locais em uma m\u00e1quina Windows, permitindo que os profissionais obtenham insights rapidamente.<\/p>\n

O roteiro<\/h2>\n
#Requires -Version 2.0\r\n\r\n<#\r\n.SYNOPSIS\r\n    Lists local computers' users.\r\n.DESCRIPTION\r\n    Lists local computers' users. By default it lists only the enabled users.\r\n.EXAMPLE\r\n    No parameters needed.\r\n    Lists enabled users on the local computer.\r\n.EXAMPLE\r\n     -AllUsers\r\n    Lists enabled and disabled users on the local computer.\r\n.EXAMPLE\r\n    PS C:> List-Users.ps1 -AllUsers\r\n    Lists enabled and disabled users on the local computer.\r\n.OUTPUTS\r\n    System.Management.Automation.SecurityAccountsManager.LocalUser[]\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 7, Windows Server 2012\r\n    Release Notes:\r\n    Initial Release\r\n.COMPONENT\r\n    ManageUsers\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    # Will return disabled users as well as enabled users\r\n    [Switch]\r\n    $AllUsers\r\n)\r\n\r\nbegin {\r\n    Write-Output \"Starting List Users\"\r\n}\r\n\r\nprocess {\r\n    # If we are running powershell under a 32bit OS or running a 32bit version of powershell\r\n    # or we don't have access to Get-LocalUser\r\n    if (\r\n        [Environment]::Is64BitProcess -ne [Environment]::Is64BitOperatingSystem -or\r\n            (Get-Command -Name \"Get-LocalUser\" -ErrorAction SilentlyContinue).Count -eq 0\r\n    ) {\r\n        # Get users from net.exe user\r\n        $Data = $(net.exe user) | Select-Object -Skip 4\r\n        # Check if the command ran the way we wanted and the exit code is 0\r\n        if ($($Data | Select-Object -last 2 | Select-Object -First 1) -like \"*The command completed successfully.*\" -and $LASTEXITCODE -eq 0) {\r\n            # Process the output and get only the users\r\n            $Users = $Data[0..($Data.Count - 3)] -split 's+' | Where-Object { -not $([String]::IsNullOrEmpty($_) -or [String]::IsNullOrWhiteSpace($_)) }\r\n            # Loop through each user\r\n            $Users | ForEach-Object {\r\n                # Get the Account active property look for a Yes\r\n                $Enabled = $(net.exe user $_) | Where-Object {\r\n                    $_ -like \"Account active*\" -and\r\n                    $($_ -split 's+' | Select-Object -Last 1) -like \"Yes\"\r\n                }\r\n                # Output Name and Enabled almost like how Get-LocalUser displays it's data\r\n                [PSCustomObject]@{\r\n                    Name    = $_\r\n                    Enabled = if ($Enabled -like \"*Yes*\") { $true }else { $false }\r\n                }\r\n            } | Where-Object { if ($AllUsers) { $_.Enabled }else { $true } }\r\n        }\r\n        else {\r\n            exit 1\r\n        }\r\n    }\r\n    else {\r\n        try {\r\n            if ($AllUsers) {\r\n                Get-LocalUser\r\n            }\r\n            else {\r\n                Get-LocalUser | Where-Object { $_.Enabled -eq $true }\r\n            }\r\n        }\r\n        catch {\r\n            Write-Error $_\r\n            exit 1\r\n        }\r\n    }\r\n}\r\n\r\nend {\r\n    Write-Output \"Completed List Users\"\r\n}<\/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
Em sua ess\u00eancia, o roteiro \u00e9 bastante simples. Ele come\u00e7a definindo um par\u00e2metro, $AllUsers<\/strong>, que, quando invocado, inclui usu\u00e1rios habilitados e desabilitados em sua sa\u00edda.\u00a0No bloco ‘process’, o script primeiro verifica a arquitetura do sistema e a disponibilidade do cmdlet Get-LocalUser<\/strong>. Se houver uma incompatibilidade ou se o cmdlet n\u00e3o estiver dispon\u00edvel, ele voltar\u00e1 a usar o comando legado net.exe user<\/strong>.\u00a0Os dados derivados de qualquer um dos m\u00e9todos s\u00e3o processados para listar os usu\u00e1rios. Quando o comando net.exe user<\/strong> \u00e9 utilizado, o script obt\u00e9m o status do usu\u00e1rio, verificando se cada conta est\u00e1 ativa. Em seguida, ele gera esses dados de forma estruturada.\u00a0Em cen\u00e1rios em que Get-LocalUser<\/strong> est\u00e1 dispon\u00edvel, ele busca e lista os usu\u00e1rios diretamente, filtrando apenas os habilitados, a menos que o par\u00e2metro $AllUsers<\/strong> seja invocado.<\/p>\n
Casos de uso em potencial<\/h2>\n
Imagine uma profissional de TI, Jane, implementando uma nova atualiza\u00e7\u00e3o de software em sua empresa. Antes de implementar a atualiza\u00e7\u00e3o, ela precisa verificar as contas de usu\u00e1rio em cada m\u00e1quina para garantir que todas as licen\u00e7as de software sejam atribu\u00eddas corretamente. Em vez de verificar manualmente cada computador, ela utiliza o script do PowerShell, economizando horas de seu valioso tempo.<\/p>\n
Compara\u00e7\u00f5es<\/h2>\n
Embora o script utilize o cmdlet Get-LocalUser<\/strong> sempre que poss\u00edvel, sua abordagem alternativa usando o usu\u00e1rio net.exe<\/strong> \u00e9 uma refer\u00eancia aos sistemas legados. Alguns outros scripts podem depender exclusivamente de cmdlets ou m\u00e9todos mais recentes. A abordagem dupla do script fornecido garante a compatibilidade com uma ampla gama de sistemas Windows, tornando-o vers\u00e1til em diversos ambientes.<\/p>\n
Implica\u00e7\u00f5es<\/h2>\n
Uma lista de usu\u00e1rios em um computador pode fornecer uma vis\u00e3o geral dos poss\u00edveis pontos de acesso para pessoas n\u00e3o autorizadas. No contexto da seguran\u00e7a de TI, entender esses usu\u00e1rios e seus status \u00e9 uma etapa fundamental para garantir que somente indiv\u00edduos autorizados tenham acesso.<\/p>\n
Recomenda\u00e7\u00f5es<\/h2>\n