Condividi tramite

New-LocalUser

  • Riferimento
Modulo:
Microsoft.PowerShell.LocalAccounts

Crea un account utente locale.

Sintassi

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>]

Descrizione

Il cmdlet New-LocalUser crea un account utente locale. Questo cmdlet crea un account utente locale.

Nota

Il modulo Microsoft.PowerShell.LocalAccounts non è disponibile in PowerShell a 32 bit in un sistema a 64 bit.

Esempio

Esempio 1: Creare un account utente

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

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

Questo comando crea un account utente locale e non specifica i parametri accountexpires o password. L'account non scade o ha una password.

Esempio 2: Creare un account utente con una password

$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.

Il primo comando usa il cmdlet Read-Host per richiedere una password. Il comando archivia la password come stringa sicura nella variabile $Password.

Il secondo comando crea un account utente locale e imposta la password del nuovo account sulla stringa sicura archiviata in $Password. Il comando specifica un nome utente, un nome completo e una descrizione per l'account utente.

Parametri

-AccountExpires

Specifica quando l'account utente scade. È possibile usare il cmdlet Get-Date per ottenere un oggetto DateTime. Se non si specifica questo parametro, l'account non scade.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-AccountNeverExpires

Indica che l'account non scade.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica un commento per l'account utente. La lunghezza massima è di 48 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Disabled

Indica che questo cmdlet crea l'account utente come disabilitato.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-FullName

Specifica il nome completo per l'account utente. Il nome completo è diverso dal nome utente dell'account utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome utente per l'account utente.

Un nome utente può contenere fino a 20 caratteri maiuscoli o minuscoli. Un nome utente non può contenere i caratteri seguenti:

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

Un nome utente non può essere costituito solo da punti . o spazi.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NoPassword

Indica che l'account utente non ha una password.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Password

Specifica una password per l'account utente. È possibile usare Read-Host -AsSecureString, Get-Credentialo ConvertTo-SecureString per creare un oggetto SecureString per la password.

Se si omettono i parametri di Password e NoPassword, New-LocalUser richiede la password del nuovo utente.

Tipo:SecureString
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PasswordNeverExpires

Indica se la password del nuovo utente scade.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-UserMayNotChangePassword

Indica che l'utente non può modificare la password nell'account utente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe una stringa a questo cmdlet.

DateTime

È possibile inviare tramite pipe un oggetto DateTime a questo cmdlet.

Boolean

È possibile inviare tramite pipe un valore booleano a questo cmdlet.

SecureString

È possibile inviare tramite pipe una stringa sicura a questo cmdlet.

Output

System.Management.Automation.SecurityAccountsManager.LocalUser

Questo cmdlet restituisce un oggetto LocalUser che rappresenta l'account utente creato.

Note

Windows PowerShell include gli alias seguenti per New-LocalUser:

  • nlu

Un nome utente non può essere identico a qualsiasi altro nome utente o nome di gruppo nel computer. Un nome utente non può essere costituito solo da punti . o spazi. Un nome utente può contenere fino a 20 caratteri maiuscoli o minuscoli. Un nome utente non può contenere i caratteri seguenti:

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

Una password può contenere fino a 127 caratteri.

La proprietà PrincipalSourceLocalUser, LocalGroupe LocalPrincipal che descrive l'origine dell'oggetto. Le possibili origini sono le seguenti:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

Nota

PrincipalSource è supportato solo da Windows 10, Windows Server 2016 e versioni successive del sistema operativo Windows. Per le versioni precedenti, la proprietà è vuota.