Set-LocalUser

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

Modifica uma conta de usuário local.

Syntax

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

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

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AccountNeverExpires

Indica que a conta não expira.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:Microsoft.PowerShell.Commands.LocalUser
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordNeverExpires

Indica se a senha expira.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SID

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

Type:SecurityIdentifier
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-UserMayChangePassword

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 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.