Set-LocalUser

Set-LocalUser
    [-Name] <String>
    [-AccountExpires <DateTime>]
    [-AccountNeverExpires]
    [-Description <String>]
    [-FullName <String>]
    [-Password <SecureString>]
    [-PasswordNeverExpires <Boolean>]
    [-UserMayChangePassword <Boolean>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-LocalUser
    [-InputObject] <LocalUser>
    [-AccountExpires <DateTime>]
    [-AccountNeverExpires]
    [-Description <String>]
    [-FullName <String>]
    [-Password <SecureString>]
    [-PasswordNeverExpires <Boolean>]
    [-UserMayChangePassword <Boolean>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-LocalUser
    [-SID] <SecurityIdentifier>
    [-AccountExpires <DateTime>]
    [-AccountNeverExpires]
    [-Description <String>]
    [-FullName <String>]
    [-Password <SecureString>]
    [-PasswordNeverExpires <Boolean>]
    [-UserMayChangePassword <Boolean>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-LocalUser cmdlet 修改本地用户帐户。 此 cmdlet 可以重置本地用户帐户的密码。

Set-LocalUser -Name "Admin07" -Description "Description of this account."

此命令更改名为 Admin07 的用户帐户的说明。

$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password

第一个命令使用 Read-Host cmdlet 提示输入密码。 该命令将密码存储为$Password变量中的安全字符串。

第二个命令使用 Get-LocalUser获取名为 User02 的用户帐户。 该命令将帐户存储在$UserAccount变量中。

第三个命令设置存储在 $UserAccount中的用户帐户的新密码。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将本地用户传递给此 cmdlet。

可以通过管道将字符串传递给此 cmdlet。

可以通过管道将 SID 传递给此 cmdlet。

此 cmdlet 不返回任何输出。

Windows PowerShell 为 Set-LocalUser提供以下别名：

• slu

PrincipalSource 属性是 LocalUser、LocalGroup和 LocalPrincipal 对象上的一个属性，用于描述对象的来源。 可能的源如下所示：

• 本地
• Active Directory
• Microsoft Entra 组
• Microsoft 帐户

PrincipalSource 仅受 Windows 10、Windows Server 2016 和更高版本的 Windows 操作系统支持。 对于早期版本，该属性为空。