New-LocalUser

Create a local user account.

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

      New-LocalUser [-Name] String
         [-AccountExpires DateTime] [-AccountNeverExpires] [-Description String]
            [-FullName String] [-NoPassword]
               [-UserMayNotChangePassword] [-WhatIf] [-Confirm] [CommonParameters]

Key
   -AccountExpires
       Specify when the user account should expire.
       To obtain a DateTime object, use Get-Date.
       If you do not want the account to expire, specify the -AccountNeverExpires parameter.

   -AccountNeverExpires
       Set the account to not expire (boolean).

   -Description
       Set a comment for the user account. The maximum length is 48 characters.

   -Disabled
       Create the user account with login disabled.

   -FullName
       Change the full name of the user account. The full name differs from the user name of the user account.

   -InputObject
       The user account that this cmdlet changes. To obtain a user account, use Get-LocalUser.

   -Name
       The name of the user account to create.
       If you create a local user account for the local system, the user name can contain up to 20 uppercase
       characters or lowercase characters.
       A user name cannot contain any of the following characters: " / \ [ ] : ; | = , + * ? < > @ 
       A user name cannot consist only of periods . or spaces.

   -NoPassword
       Indicate that the user account does not have a password.

   -Password SecureString
       Specify a new password for the user account.
       If the user account is connected to a Microsoft account, do not set a password.
       You can use Read-Host -GetCredential, Get-Credential, or ConvertTo-SecureString to create a SecureString
       object for the password.
       If you omit the Password you will be prompted for a password to set.
       A password can contain up to 127 characters.

   -PasswordNeverExpires
       Indicate whether the password expires (boolean).

   -UserMayNotChangePassword
       Indicate that the user cannot change the password on the user account.

   -Confirm
       Prompt for confirmation before executing the command.

   -WhatIf
       Describe what would happen if you executed the command without actually executing the command.

A user name cannot be identical to any other user name or group name on the computer.
A user name can contain up to 20 uppercase characters or lowercase characters.

This cmdlet does not generate any output.

Examples

Create a local user account:

PS C:\> New-LocalUser -Name "Kiosk64" -Description "Local Kiosk account." -NoPassword

Create a user account that has a password:

PS C:\> New-LocalUser "User64" -Password (Read-Host -AsSecureString) -FullName "Demo User" -Description "Temporary test account."

“Innovations that are guided by smallholder farmers, adapted to local circumstances, and sustainable for the economy and environment will be necessary to ensure food security in the future” ~ Bill Gates

Related PowerShell Cmdlets

New-adUser - Create a new AD user account.
Set-LocalUser - Modify a local user account.
New-LocalGroup - Add a new local security group.


 
Copyright © 1999-2023 SS64.com
Some rights reserved