{"id":810792,"date":"2026-05-21T11:59:00","date_gmt":"2026-05-21T11:59:00","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=810792"},"modified":"2026-05-21T11:59:00","modified_gmt":"2026-05-21T11:59:00","slug":"como-usar-o-powershell-para-encontrar-administradores-locais","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/pt-br\/script-hub\/como-usar-o-powershell-para-encontrar-administradores-locais\/","title":{"rendered":"Como usar o PowerShell para localizar administradores locais"},"content":{"rendered":"

Na era digital atual, a administra\u00e7\u00e3o de sistemas e o gerenciamento de seguran\u00e7a geralmente exigem o uso de scripts. Um aspecto vital da manuten\u00e7\u00e3o da seguran\u00e7a do sistema \u00e9 o controle dos administradores locais em m\u00e1quinas Windows. Usar o PowerShell para obter esses dados pode ser um divisor de \u00e1guas para muitos profissionais de TI. Leia este artigo para saber como usar o PowerShell para localizar administradores locais. <\/strong><\/p>\n

Hist\u00f3rico<\/h2>\n

O PowerShell evoluiu como uma linguagem de script e um shell robustos. Especialmente para profissionais de TI e provedores de servi\u00e7os gerenciados (MSPs)<\/a>, scripts como o fornecido tornam-se indispens\u00e1veis. Os MSPs geralmente gerenciam v\u00e1rios ambientes de clientes, o que torna dif\u00edcil monitorar cada detalhe manualmente. Ao utilizar scripts para obter informa\u00e7\u00f5es, como a lista de administradores locais, os MSPs podem garantir que somente indiv\u00edduos autorizados tenham acesso elevado, protegendo-se contra poss\u00edveis amea\u00e7as e atividades mal-intencionadas.<\/p>\n

O roteiro<\/h2>\n
<#\r\n.SYNOPSIS\r\n    Updates a custom field with a list of local admins.\r\n.DESCRIPTION\r\n    Updates a custom field with a list of local admins.\r\n.EXAMPLE\r\n    No parameter needed\r\n    \r\n    Local Admins Found: Administrator, kbohlander, TESTDomain Admins\r\n    Attempting to set Custom Field: LocalAdmins\r\n\r\nPARAMETER: -CustomField \"ReplaceWithAnyTextCustomField\"    \r\n    Updates the custom field you specified (defaults to \"LocalAdmins\"). The Custom Field needs to be writable by scripts (otherwise the script will report it as not found).\r\n\r\nPARAMETER: -Delimiter \"ReplaceWithYourDesiredDelimiter\"\r\n    Places whatever is entered encased of quotes between each user name. See below example.\r\n.EXAMPLE\r\n    -Delimiter \" - \"\r\n    \r\n    Local Admins Found: Administrator - kbohlander - TESTDomain Admins\r\n    Attempting to set Custom Field: LocalAdmins\r\n.OUTPUTS\r\n    None\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 7, Windows Server 2008\r\n    Release Notes:\r\n    Switched to using net localgroup as it's the most reliable. Removed PowerShell 5.1 requirement.\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    [Parameter()]\r\n    [String]$CustomField = \"LocalAdmins\",\r\n    [Parameter()]\r\n    [String]$Delimiter = ', '\r\n)\r\n\r\nbegin {\r\n    if ($env:customFieldName -and $env:customFieldName -notlike \"null\") { $CustomField = $env:customFieldName }\r\n    if ($env:delimiter -and $env:delimiter -notlike \"null\") { $Delimiter = $env:delimiter }\r\n    $CheckNinjaCommand = \"Ninja-Property-Set\"\r\n}\r\nprocess {\r\n    # Get objects in the Administrators group, includes user objects and groups\r\n    $Users = net.exe localgroup \"Administrators\" | Where-Object { $_ -AND $_ -notmatch \"command completed successfully\" } | Select-Object -Skip 4\r\n\r\n    if (-not $Users) {\r\n        Write-Error \"[Error] No user's found! This is extremely unlikely is something blocking access to 'net localgroup administrators'?\"\r\n        exit 1\r\n    }\r\n\r\n    Write-Host \"Local Admins Found (Users & Groups): $($Users -join $Delimiter)\"\r\n    if ($(Get-Command $CheckNinjaCommand -ErrorAction SilentlyContinue).Name -like $CheckNinjaCommand -and -not [string]::IsNullOrEmpty($CustomField) -and -not [string]::IsNullOrWhiteSpace($CustomField)) {\r\n        Write-Host \"Attempting to set Custom Field: $CustomField\"\r\n        Ninja-Property-Set -Name $CustomField -Value $($Users -join $Delimiter)\r\n    }\r\n    else {\r\n        Write-Warning \"Unable to set customfield either due to legacy OS or this script is not running as an elevated user.\"\r\n    }\r\n}\r\nend {\r\n    \r\n    \r\n    \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
O script \u00e9 iniciado com a defini\u00e7\u00e3o de par\u00e2metros padr\u00e3o, principalmente visando a um campo personalizado chamado “LocalAdmins” e usando uma v\u00edrgula como delimitador<\/a> padr\u00e3o. Veja como funciona:<\/p>\n