Compartir a través de

Set-LocalUser

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Modifica una cuenta de usuario local.

Sintaxis

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

El cmdlet Set-LocalUser modifica una cuenta de usuario local. Este cmdlet puede restablecer la contraseña de una cuenta de usuario local.

Nota

El módulo Microsoft.PowerShell.LocalAccounts no está disponible en PowerShell de 32 bits en un sistema de 64 bits.

Ejemplos

Ejemplo 1: Cambiar una descripción de una cuenta de usuario

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

Este comando cambia la descripción de una cuenta de usuario denominada Admin07.

Ejemplo 2: Cambiar la contraseña en una cuenta

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

El primer comando le pide una contraseña mediante el cmdlet Read-Host. El comando almacena la contraseña como una cadena segura en la variable $Password.

El segundo comando obtiene una cuenta de usuario denominada User02 mediante Get-LocalUser. El comando almacena la cuenta en la variable $UserAccount.

El tercer comando establece la nueva contraseña de la cuenta de usuario almacenada en $UserAccount.

Parámetros

-AccountExpires

Especifica cuándo expira la cuenta de usuario. Para obtener un objeto DateTime, use el cmdlet Get-Date.

Si no desea que la cuenta expire, especifique el parámetro AccountNeverExpires.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AccountNeverExpires

Indica que la cuenta no expira.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica un comentario para la cuenta de usuario. La longitud máxima es de 48 caracteres.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FullName

Especifica el nombre completo de la cuenta de usuario. El nombre completo difiere del nombre de usuario de la cuenta de usuario.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica la cuenta de usuario que cambia este cmdlet. Para obtener una cuenta de usuario, use el cmdlet Get-LocalUser.

Tipo:Microsoft.PowerShell.Commands.LocalUser
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre de la cuenta de usuario que cambia este cmdlet.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Password

Especifica una contraseña para la cuenta de usuario. Si la cuenta de usuario está conectada a una cuenta Microsoft, no establezca una contraseña.

Puede usar Read-Host -AsSecureString, Get-Credentialo ConvertTo-SecureString para crear un objeto SecureString para la contraseña.

Si omite los parámetros Password y NoPassword, Set-LocalUser le pedirá la contraseña del usuario.

Tipo:SecureString
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PasswordNeverExpires

Indica si expira la contraseña.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SID

Especifica el identificador de seguridad (SID) de la cuenta de usuario que cambia este cmdlet.

Tipo:SecurityIdentifier
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-UserMayChangePassword

Indica que el usuario puede cambiar la contraseña en la cuenta de usuario.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

System.Management.Automation.SecurityAccountsManager.LocalUser

Puede canalizar un usuario local a este cmdlet.

String

Puede canalizar una cadena a este cmdlet.

SecurityIdentifier

Puede canalizar un SID a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida.

Notas

Windows PowerShell incluye los siguientes alias para Set-LocalUser:

  • slu

La propiedad principalSource es una propiedad de LocalUser, LocalGroupy objetos LocalPrincipal que describen el origen del objeto. Los orígenes posibles son los siguientes:

  • Local
  • Active Directory
  • Grupo Entra de Microsoft
  • Cuenta Microsoft

principalSource solo es compatible con Windows 10, Windows Server 2016 y versiones posteriores del sistema operativo Windows. Para versiones anteriores, la propiedad está en blanco.