New-LocalUser

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Crea una cuenta de usuario local.

Syntax

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 New-LocalUser cmdlet 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 Read-Host cmdlet para solicitar una contraseña. El comando almacena la contraseña como una cadena segura en la $Password variable .

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 Get-Date cmdlet para obtener un objeto DateTime . Si no especifica este parámetro, la cuenta no expira.

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

-AccountNeverExpires

Indica que la cuenta no expira.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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:True
Accept wildcard characters:False

-Disabled

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

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

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

-NoPassword

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

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

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

-PasswordNeverExpires

Indica si expira la contraseña del nuevo usuario.

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

-UserMayNotChangePassword

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

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 en objetos LocalUser, LocalGroup y 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.