Set-LocalUser

Referência

Módulo:: Microsoft.PowerShell.LocalAccounts

Modifica uma conta de utilizador 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 utilizador local. Este cmdlet pode redefinir a palavra-passe de uma conta de utilizador local.

Nota

O módulo Microsoft.PowerShell.LocalAccounts não está disponível em PowerShell de 32 bits num 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 utilizador 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-lhe uma palavra-passe utilizando o Read-Host cmdlet. O comando armazena a palavra-passe como uma cadeia segura na variável $Password.

O segundo comando obtém uma conta de utilizador chamada User02 através da utilização Get-LocalUser. O comando armazena a conta na variável $UserAccount.

O terceiro comando define a nova palavra-passe na conta de utilizador armazenada em $UserAccount.

Parâmetros

- O QueIf

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

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

-AccountNeverExpires

Indica que a conta não expira.

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

-Confirm

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

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

-ContasExpires

Especifica quando a conta de utilizador expira. Para obter um objeto DateTime , utilize o Get-Date cmdlet.

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

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

-Descrição

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

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

-FullName

Especifica o nome completo para a conta de utilizador. O nome completo difere do nome de utilizador da conta do utilizador.

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

-InputObject

Especifica a conta de utilizador que este cmdlet altera. Para obter uma conta de utilizador, utilize o Get-LocalUser cmdlet.

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

-Name

Especifica o nome da conta de utilizador que este cmdlet altera.

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

-Password

Especifica uma palavra-passe para a conta de utilizador. Se a conta de utilizador estiver ligada a uma conta Microsoft, não desconte uma palavra-passe.

Pode utilizar Read-Host -GetCredential, Get-Credentialou ConvertTo-SecureString criar um objeto SecureString para a palavra-passe.

Se omitir os parâmetros Palavra-Passe e NoPassword , Set-LocalUser solicita-lhe a palavra-passe do utilizador.

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

-PasswordNeverExpires

Indica se a palavra-passe expira.

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

-SID

Especifica o ID de segurança (SID) da conta de utilizador que este cmdlet altera.

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

-UserMayChangePassword

Indica que o utilizador pode alterar a palavra-passe na conta de utilizador.

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

Entradas

System.Management.Automation.SecurityAccountsManager.LocalUser, System.String, System.Security.Principal.SecurityIdentifier

Pode canalizar um utilizador local, uma corda ou um SID para este cmdlet.

Saídas

Nenhuma

Este cmdlet não gera qualquer saída.

Notas

A propriedade PrincipalSource é uma propriedade em LocalUser, LocalGroup e Objetos LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:
Local
Active Directory
Azure Ative Directory grupo
Conta Microsoft

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