Set-LocalUser

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Modifica una cuenta de usuario 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

El Set-LocalUser cmdlet 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 Administración 07.

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 en 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 Get-Date cmdlet .

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

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

-AccountNeverExpires

Indica que la cuenta no expira.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Description

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

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

-FullName

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

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

-InputObject

Especifica la cuenta de usuario que cambia este cmdlet. Para obtener una cuenta de usuario, use el 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 el nombre de la cuenta de usuario que cambia este cmdlet.

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

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

-PasswordNeverExpires

Indica si expira la contraseña.

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

-SID

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

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

-UserMayChangePassword

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

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

-WhatIf

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

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

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 ningún resultado.

Notas

Windows PowerShell incluye los siguientes alias para Set-LocalUser:

  • slu

La propiedad PrincipalSource es una propiedad en objetos LocalUser, LocalGroup y LocalPrincipal que describen el origen del objeto. Los orígenes posibles son los siguientes:

  • Local
  • Active Directory
  • Grupo de Microsoft Entra
  • 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.