Set-LocalUser
Modifica uma conta de usuário local.
Sintaxe
Name (Predefinição)
Set-LocalUser
[-Name] <String>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Set-LocalUser
[-InputObject] <LocalUser>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Set-LocalUser
[-SID] <SecurityIdentifier>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Set-LocalUser 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 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 cmdlet Get-Date.
Se você não quiser que a conta expire, especifique o parâmetro AccountNeverExpires.
Propriedades dos parâmetros
| Tipo: | DateTime |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-AccountNeverExpires
Indica que a conta não expira.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Description
Especifica um comentário para a conta de usuário. O comprimento máximo é de 48 caracteres.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Especifica a conta de usuário que esse cmdlet altera. Para obter uma conta de usuário, use o cmdlet Get-LocalUser.
Propriedades dos parâmetros
| Tipo: | Microsoft.PowerShell.Commands.LocalUser |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
InputObject
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Name
Especifica o nome da conta de usuário que esse cmdlet altera.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Name
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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 o de senha e parâmetros NoPassword, Set-LocalUser solicitará a senha do usuário.
Propriedades dos parâmetros
| Tipo: | SecureString |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PasswordNeverExpires
Indica se a senha expira.
Propriedades dos parâmetros
| Tipo: | Boolean |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SID
Especifica a ID de segurança (SID) da conta de usuário que esse cmdlet altera.
Propriedades dos parâmetros
| Tipo: | SecurityIdentifier |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
SecurityIdentifier
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-UserMayChangePassword
Indica que o usuário pode alterar a senha na conta de usuário.
Propriedades dos parâmetros
| Tipo: | Boolean |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
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, LocalGroupe LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:
- Locais
- 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.
