Compartir a través de

New-LocalUser

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Crea una cuenta de usuario local.

Sintaxis

New-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-Disabled]
   [-FullName <String>]
   [-Name] <String>
   -Password <SecureString>
   [-PasswordNeverExpires]
   [-UserMayNotChangePassword]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-Disabled]
   [-FullName <String>]
   [-Name] <String>
   [-NoPassword]
   [-UserMayNotChangePassword]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-LocalUser crea una cuenta de usuario local. Este cmdlet crea 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: Creación de una cuenta de usuario

New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword

Name    Enabled  Description
----    -------  -----------
User02  True     Description of this account.

Este comando crea una cuenta de usuario local y no especifica los parámetros AccountExpires ni Password. La cuenta no expira ni tiene una contraseña.

Ejemplo 2: Crear una cuenta de usuario que tenga una contraseña

$Password = Read-Host -AsSecureString
$params = @{
    Name        = 'User03'
    Password    = $Password
    FullName    = 'Third User'
    Description = 'Description of this account.'
}
New-LocalUser @params

Name    Enabled  Description
----    -------  -----------
User03  True     Description of this account.

El primer comando usa el cmdlet Read-Host para solicitar una contraseña. El comando almacena la contraseña como una cadena segura en la variable $Password.

El segundo comando crea una cuenta de usuario local y establece la contraseña de la nueva cuenta en la cadena segura almacenada en $Password. El comando especifica un nombre de usuario, un nombre completo y una descripción para la cuenta de usuario.

Parámetros

-AccountExpires

Especifica cuándo expira la cuenta de usuario. Puede usar el cmdlet Get-Date para obtener un objeto DateTime. Si no especifica este parámetro, la cuenta no expira.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
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:True
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:True
Aceptar caracteres comodín:False

-Disabled

Indica que este cmdlet crea la cuenta de usuario como deshabilitada.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
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:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre de usuario de la cuenta de usuario.

Un nombre de usuario puede contener hasta 20 caracteres mayúsculas o caracteres en minúsculas. Un nombre de usuario no puede contener los siguientes caracteres:

", /, \, [, ], :, ;, |, =, ,, +, *, ?, <, >@

Un nombre de usuario no puede constar solo de períodos . o espacios.

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

-NoPassword

Indica que la cuenta de usuario no tiene una contraseña.

Tipo:SwitchParameter
Posición:Named
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. 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, New-LocalUser le pedirá la contraseña del nuevo usuario.

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

-PasswordNeverExpires

Indica si expira la contraseña del nuevo usuario.

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

-UserMayNotChangePassword

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
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

String

Puede canalizar una cadena a este cmdlet.

DateTime

Puede canalizar un objeto DateTime a este cmdlet.

Boolean

Puede canalizar un valor booleano a este cmdlet.

SecureString

Puede canalizar una cadena segura a este cmdlet.

Salidas

System.Management.Automation.SecurityAccountsManager.LocalUser

Este cmdlet devuelve un objeto LocalUser que representa la cuenta de usuario creada.

Notas

Windows PowerShell incluye los siguientes alias para New-LocalUser:

  • nlu

Un nombre de usuario no puede ser idéntico a ningún otro nombre de usuario o nombre de grupo en el equipo. Un nombre de usuario no puede constar solo de períodos . o espacios. Un nombre de usuario puede contener hasta 20 caracteres mayúsculas o caracteres en minúsculas. Un nombre de usuario no puede contener los siguientes caracteres:

", /, \, [, ], :, ;, |, =, ,, +, *, ?, <, >@

Una contraseña puede contener hasta 127 caracteres.

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
  • AzureAD
  • MicrosoftAccount

Nota

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.