Compartilhar via

Set-LocalUser

  • Referência
Módulo:
Microsoft.PowerShell.LocalAccounts

Modifica uma conta de usuário local.

Sintaxe

Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-Name] <String>
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-InputObject] <LocalUser>
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-SID] <SecurityIdentifier>
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O Set-LocalUser cmdlet modifica uma conta de usuário local. Esse cmdlet pode redefinir a senha de uma conta de usuário local.

Observação

O módulo Microsoft.PowerShell.LocalAccounts não está disponível no PowerShell de 32 bits em um sistema de 64 bits.

Exemplos

Exemplo 1: Alterar uma descrição de uma conta de usuário

Set-LocalUser -Name "Admin07" -Description "Description of this account."

Esse comando altera a descrição de uma conta de usuário chamada Admin07.

Exemplo 2: Alterar a senha em uma conta

$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password

O primeiro comando solicita uma senha usando o cmdlet Read-Host. O comando armazena a senha como uma string segura na variável $Password.

O segundo comando obtém uma conta de usuário chamada User02 usando Get-LocalUser. O comando armazena a conta na variável $UserAccount.

O terceiro comando define a nova senha na conta de usuário armazenada no $UserAccount.

Parâmetros

-AccountExpires

Especifica quando a conta de usuário expira. Para obter um objeto DateTime , use o Get-Date cmdlet.

Se você não quiser que a conta expire, especifique o parâmetro AccountNeverExpires .

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AccountNeverExpires

Indica que a conta não expira.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica um comentário para a conta de usuário. O comprimento máximo é de 48 caracteres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FullName

Especifica o nome completo da conta de usuário. O nome completo difere do nome de usuário da conta de usuário.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica a conta de usuário que esse cmdlet altera. Para obter uma conta de usuário, use o Get-LocalUser cmdlet.

Tipo:Microsoft.PowerShell.Commands.LocalUser
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica o nome da conta de usuário que esse cmdlet altera.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Password

Especifica uma senha para a conta de usuário. Se a conta de usuário estiver conectada a uma conta da Microsoft, não defina uma senha.

Você pode usar Read-Host -AsSecureString, Get-Credentialou ConvertTo-SecureString para criar um objeto SecureString para a senha.

Se você omitir os parâmetros Password e NoPassword , Set-LocalUser solicitará a senha do usuário.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PasswordNeverExpires

Indica se a senha expira.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SID

Especifica a SID (ID de segurança) da conta de usuário que esse cmdlet altera.

Tipo:SecurityIdentifier
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-UserMayChangePassword

Indica que o usuário pode alterar a senha na conta de usuário.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.Management.Automation.SecurityAccountsManager.LocalUser

Você pode canalizar um usuário local para esse cmdlet.

String

Você pode canalizar uma cadeia de caracteres para esse cmdlet.

SecurityIdentifier

Você pode canalizar um SID para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O Windows PowerShell inclui os seguintes aliases para Set-LocalUser:

  • slu

A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroup e LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:

  • Local
  • Active Directory
  • Grupo do Microsoft Entra
  • Conta da Microsoft

PrincipalSource tem suporte apenas para Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Para versões anteriores, a propriedade está em branco.