Partilhar 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.

Nota

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 utilizador

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

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

Exemplo 2: Alterar a palavra-passe numa 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 cadeia de caracteres 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AccountNeverExpires

Indica que a conta não expira.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

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

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Password

Especifica uma senha para a conta de usuário. Se a conta de utilizador estiver ligada a uma conta Microsoft, não defina uma palavra-passe.

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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PasswordNeverExpires

Indica se a senha expira.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SID

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

Tipo:SecurityIdentifier
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-UserMayChangePassword

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

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 este cmdlet.

SecurityIdentifier

Você pode canalizar um SID para este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

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 Microsoft Entra
  • Conta Microsoft

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