{"id":810788,"date":"2026-05-21T11:58:12","date_gmt":"2026-05-21T11:58:12","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=810788"},"modified":"2026-05-21T11:58:12","modified_gmt":"2026-05-21T11:58:12","slug":"como-redefinir-senhas-de-usuario-usando-o-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/pt-br\/script-hub\/como-redefinir-senhas-de-usuario-usando-o-powershell\/","title":{"rendered":"Como redefinir senhas de usu\u00e1rio usando o PowerShell"},"content":{"rendered":"

A capacidade de gerenciar o acesso e as credenciais dos usu\u00e1rios \u00e9 um componente essencial da administra\u00e7\u00e3o de TI. Seja em uma grande organiza\u00e7\u00e3o com necessidades complexas de TI ou em uma empresa menor com requisitos simples, uma tarefa comum \u00e9 o gerenciamento de senhas. O script fornecido apresenta um m\u00e9todo para redefinir senhas de usu\u00e1rios usando o PowerShell<\/strong>, seja para usu\u00e1rios locais do Windows ou em um ambiente do Active Directory.<\/p>\n

Hist\u00f3rico<\/h2>\n

O script foi projetado principalmente para oferecer aos profissionais de TI e aos provedores de servi\u00e7os gerenciados (MSPs)<\/a> uma abordagem simplificada para redefinir as senhas dos usu\u00e1rios sem se aprofundar nas interfaces de usu\u00e1rio do sistema. Com o n\u00famero cada vez maior de usu\u00e1rios e a necessidade constante de aplicar pr\u00e1ticas de seguran\u00e7a, ter uma ferramenta que realize essas opera\u00e7\u00f5es de forma r\u00e1pida e confi\u00e1vel \u00e9 inestim\u00e1vel. Esse script, especialmente quando combinado com ferramentas como o NinjaOne, oferece automa\u00e7\u00e3o e efici\u00eancia<\/a> para essas tarefas.<\/p>\n

O roteiro<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Resets a users password.\r\n.DESCRIPTION\r\n    Resets a users password. Either a local user that this script runs on, or in Active directory.\r\n.EXAMPLE\r\n     -UserName \"Fred\" -Password \"Somepass1\"\r\n    Resets Fred's password to Somepass1 .\r\n.EXAMPLE\r\n     -UserName \"Fred\" -Password \"Somepass1\" -IsDomainUser\r\n    Resets Fred's password to Somepass1 in Active Directory.\r\n.EXAMPLE\r\n    PS C:> .Reset-User-Password.ps1 -UserName \"Fred\" -Password \"Somepass1\" -IsDomainUser\r\n    Resets Fred's password to Somepass1 in Active Directory.\r\n.OUTPUTS\r\n    None\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2012\r\n    The RSAT feature for Active Directory needs to be installed on the computer this runs on.\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()]\r\nparam (\r\n    [Parameter(Mandatory = $true)]\r\n    [String]\r\n    $UserName,\r\n    [Parameter(Mandatory = $true)]\r\n    [String]\r\n    $Password,\r\n    [Switch]\r\n    $IsDomainUser\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    \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 ($IsDomainUser) {\r\n        # Active Directory\r\n        # Check if the ActiveDirectory module is installed\r\n        if ((Get-Module -Name ActiveDirectory -ListAvailable -ErrorAction SilentlyContinue)) {\r\n            try {\r\n                # Try to import the ActiveDirectory module\r\n                Import-Module -Name ActiveDirectory\r\n            }\r\n            catch {\r\n                Write-Error -Message \"Ninja Agent could not access AD, either RSAT was not installed or that the agent does not have permissions to add and remove users from groups.\"\r\n                exit 5 # Access Denied exit code\r\n            }\r\n            try {\r\n                $User = Get-ADUser -Identity $UserName\r\n                Set-ADAccountPassword -Identity $User -Reset -NewPassword $(ConvertTo-SecureString -String $Password -AsPlainText -Force)    \r\n                Write-Host \"Reset Password for user: $UserName\"\r\n                exit 0\r\n            }\r\n            catch {\r\n                Write-Host \"Failed to Reset Password for user: $UserName\"\r\n                exit 1\r\n            }\r\n        }\r\n        else {\r\n            Write-Host \"User ($UserName) does not exist.\"\r\n            exit 1\r\n        }\r\n    }\r\n    else {\r\n        $User = Get-LocalUser -Name $UserName -ErrorAction SilentlyContinue\r\n        if ($User) {\r\n            try {\r\n                Set-LocalUser -Name $UserName -Password $(ConvertTo-SecureString -String $Password -AsPlainText -Force) -Confirm:$false\r\n                Write-Host \"Reset Password for user: $UserName\"\r\n                exit 0\r\n            }\r\n            catch {\r\n                Write-Host \"Failed to Reset Password for user: $UserName\"\r\n                exit 1\r\n            }\r\n        }\r\n        else {\r\n            Write-Host \"User ($UserName) does not exist.\"\r\n            exit 1\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
Par\u00e2metros: O script come\u00e7a definindo os par\u00e2metros necess\u00e1rios, ou seja, o UserName e a Password. H\u00e1 tamb\u00e9m uma chave opcional para IsDomainUser que, quando usada, especifica que a opera\u00e7\u00e3o se destina a um usu\u00e1rio do Active Directory.<\/p>\n
Inicializa\u00e7\u00e3o:<\/h3>\n
Antes da opera\u00e7\u00e3o principal, o script verifica se est\u00e1 sendo executado com privil\u00e9gios de administrador. Isso \u00e9 feito usando a fun\u00e7\u00e3o Test-IsElevated, que verifica a fun\u00e7\u00e3o de execu\u00e7\u00e3o atual do script.<\/p>\n
Processo:<\/h3>\n
Dependendo do valor da chave IsDomainUser, o script se divide em duas opera\u00e7\u00f5es distintas:<\/p>\n