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

Password

このアカウントに使用するパスワードを使用して資格情報を指定します。 資格情報オブジェクトの 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

例

• 新しいユーザーを作成する