New-LocalUser
创建本地用户帐户。
语法
Password (默认值)
New-LocalUser
[-Name] <String>
-Password <SecureString>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-PasswordNeverExpires]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NoPassword
New-LocalUser
[-Name] <String>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-NoPassword]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
New-LocalUser cmdlet 创建本地用户帐户。 此 cmdlet 创建本地用户帐户。
注释
Microsoft.PowerShell.LocalAccounts 模块在 64 位系统上的 32 位 PowerShell 中不可用。
示例
示例 1:创建用户帐户
New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword
Name Enabled Description
---- ------- -----------
User02 True Description of this account.
此命令创建本地用户帐户,不指定 AccountExpires 或 Password 参数。 帐户不会过期或具有密码。
示例 2:创建具有密码的用户帐户
$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.
第一个命令使用 Read-Host cmdlet 提示输入密码。 该命令将密码存储为 $Password 变量中的安全字符串。
第二个命令创建本地用户帐户,并将新帐户的密码设置为存储在 $Password中的安全字符串。 该命令指定用户帐户的用户名、全名和说明。
参数
-AccountExpires
指定用户帐户过期的时间。 可以使用 Get-Date cmdlet 获取 DateTime 对象。 如果未指定此参数,则帐户不会过期。
参数属性
| 类型: | DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-AccountNeverExpires
指示帐户不会过期。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Description
指定用户帐户的注释。 最大长度为 48 个字符。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Disabled
指示此 cmdlet 将用户帐户创建为已禁用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-FullName
指定用户帐户的全名。 全名不同于用户帐户的用户名。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Name
指定用户帐户的用户名。
用户名最多可以包含 20 个大写字符或小写字符。 用户名不能包含以下字符:
"、/、\、[、]、:、;、|、=、,、+、*、?、<、>、@
用户名不能仅包含句点 . 或空格。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-NoPassword
指示用户帐户没有密码。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NoPassword
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Password
指定用户帐户的密码。 可以使用 Read-Host -AsSecureString、Get-Credential或 ConvertTo-SecureString 为密码创建 SecureString 对象。
如果省略 密码 和 NoPassword 参数,New-LocalUser 会提示输入新用户的密码。
参数属性
| 类型: | SecureString |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Password
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-PasswordNeverExpires
指示新用户的密码是否过期。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Password
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-UserMayNotChangePassword
指示用户无法更改用户帐户的密码。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未能运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输入
String
可以通过管道将字符串传递给此 cmdlet。
DateTime
可以通过管道将 DateTime 对象传递给此 cmdlet。
Boolean
可以通过管道将布尔值传递给此 cmdlet。
SecureString
可以通过管道将安全字符串传递给此 cmdlet。
输出
System.Management.Automation.SecurityAccountsManager.LocalUser
此 cmdlet 返回表示创建的用户帐户的 LocalUser 对象。
备注
Windows PowerShell 为 New-LocalUser提供以下别名:
nlu
用户名不能与计算机上的任何其他用户名或组名称相同。 用户名不能仅包含句点 . 或空格。 用户名最多可以包含 20 个大写字符或小写字符。 用户名不能包含以下字符:
"、/、\、[、]、:、;、|、=、,、+、*、?、<、>、@
密码最多可以包含 127 个字符。
PrincipalSource 属性是 LocalUser、LocalGroup和 LocalPrincipal 对象上的一个属性,用于描述对象的来源。 可能的源如下所示:
LocalActive DirectoryAzureADMicrosoftAccount
注释
PrincipalSource 仅受 Windows 10、Windows Server 2016 和更高版本的 Windows 操作系统支持。 对于早期版本,该属性为空。