User

  • 项目

摘要

管理本地用户。

语法

User [String] #ResourceName
{
    UserName = [string]
    [DependsOn = [string[]]]
    [Description = [string]]
    [Disabled = [bool]]
    [Ensure = [string]{ Absent | Present }]
    [FullName = [string]]
    [Password = [PSCredential]]
    [PasswordChangeNotAllowed = [bool]]
    [PasswordChangeRequired = [bool]]
    [PasswordNeverExpires = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
}

说明

利用该 User 资源，可以添加、更新和删除本地用户帐户。 若要管理本地组中帐户的成员身份，请参阅 “组”资源。

要求

无

属性

密钥属性

UserName

将帐户的名称指定为字符串。

Type: System.String

可选属性

说明

将帐户的描述符指定为字符串。

Type: System.String
Default Value: None

已禁用

指定是否禁用帐户。 将此属性设置为 $true 禁用帐户（如果已启用）。 将其设置为 $false 启用帐户（如果已禁用）。

默认值为 $false。

Type: System.Boolean
Default Value: false

Ensure

指定用户是否应存在。 将此属性设置为 Present 添加或更新帐户。 将此属性设置为 Absent 删除帐户。

默认值为 Present。

Type: System.String
Behavior: Write
Accepted Values:
  - Absent
  - Present
Default Value: Present

FullName

将帐户的全名指定为字符串。

Type: System.String
Default Value: None

密码

指定具有用于此帐户的密码的凭据。 凭据对象的 UserName 未使用，仅使用 密码。

Type: System.Management.Automation.PSCredential
Default Value: None

PasswordChangeNotAllowed

指定用户是否可以更改其密码。 将此属性设置为 $true 阻止用户更改其密码。 将此属性设置为 $false 允许用户更改其密码。

默认值为 $false。

Type: System.Boolean
Default Value: false

PasswordChangeRequired

指定用户是否必须更改其密码。 将此属性设置为 $true 强制用户在下次登录时更改其密码。 将此属性设置为 $false 不要求用户更改其密码。

默认值为 $true。

Type: System.Boolean
Default Value: true

PasswordNeverExpires

指定密码是否过期。 将此属性设置为 $true 阻止帐户的密码过期。 将此属性设置为 $false 使帐户的密码按系统安全设置过期。

默认值为 $false。

Type: System.Boolean
Default Value: false

示例