New-LocalUser

モジュール:

Microsoft.PowerShell.LocalAccounts

ローカル ユーザー アカウントを作成します。

構文

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

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

説明

New-LocalUser コマンドレットは、ローカル ユーザー アカウントを作成します。 このコマンドレットは、ローカル ユーザー アカウントを作成します。

手記

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 コマンドレットを使用してパスワードの入力を求めます。 このコマンドは、パスワードをセキュリティで保護された文字列として $Password 変数に格納します。

2 番目のコマンドは、ローカル ユーザー アカウントを作成し、新しいアカウントのパスワードを $Passwordに格納されているセキュリティで保護された文字列に設定します。 このコマンドは、ユーザー アカウントのユーザー名、フル ネーム、および説明を指定します。

パラメーター

-AccountExpires

ユーザー アカウントの有効期限を指定します。 Get-Date コマンドレットを使用して、DateTime オブジェクトを取得できます。 このパラメーターを指定しない場合、アカウントは期限切れになりません。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-AccountNeverExpires

アカウントの有効期限が切れないことを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

ユーザー アカウントのコメントを指定します。 最大長は 48 文字です。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Disabled

このコマンドレットによって、ユーザー アカウントが無効として作成されることを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-FullName

ユーザー アカウントの完全な名前を指定します。 完全な名前は、ユーザー アカウントのユーザー名とは異なります。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

ユーザー アカウントのユーザー名を指定します。

ユーザー名には、最大 20 文字の大文字または小文字を含めることができます。 ユーザー名に次の文字を含めることはできません。

", /, \, [, ], :, ;, |, =,, +, *, ?, <, >, @

ユーザー名は、ピリオド . またはスペースのみで構成することはできません。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-NoPassword

ユーザー アカウントにパスワードがないことを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Password

ユーザー アカウントのパスワードを指定します。 Read-Host -AsSecureString、Get-Credential、または ConvertTo-SecureString を使用して、パスワードの SecureString オブジェクトを作成できます。

パスワード を省略し、NoPassword パラメーターを すると、New-LocalUser は新しいユーザーのパスワードの入力を求められます。

型:	SecureString
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-PasswordNeverExpires

新しいユーザーのパスワードの有効期限が切れるかどうかを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-UserMayNotChangePassword

ユーザーがユーザー アカウントのパスワードを変更できないことを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

String

このコマンドレットに文字列をパイプできます。

DateTime

DateTime オブジェクトをこのコマンドレットにパイプできます。

Boolean

このコマンドレットには、ブール値をパイプ処理できます。

SecureString

セキュリティで保護された文字列をこのコマンドレットにパイプできます。

出力

System.Management.Automation.SecurityAccountsManager.LocalUser

このコマンドレットは、作成されたユーザー アカウントを表す LocalUser オブジェクトを返します。

メモ

Windows PowerShell には、New-LocalUserの次のエイリアスが含まれています。

• nlu

ユーザー名は、コンピューター上の他のユーザー名またはグループ名と同じにすることはできません。 ユーザー名は、ピリオド . またはスペースのみで構成することはできません。 ユーザー名には、最大 20 文字の大文字または小文字を含めることができます。 ユーザー名に次の文字を含めることはできません。

", /, \, [, ], :, ;, |, =,, +, *, ?, <, >, @

パスワードには、最大 127 文字を含めることができます。

PrincipalSource プロパティは、LocalUser 、LocalGroup、およびオブジェクトのソースを記述する LocalPrincipal オブジェクトプロパティです。 考えられるソースは次のとおりです。

• Local
• Active Directory
• AzureAD
• MicrosoftAccount

手記

PrincipalSource は、Windows 10、Windows Server 2016、およびそれ以降のバージョンの Windows オペレーティング システムでのみサポートされます。 以前のバージョンの場合、プロパティは空白です。

関連リンク

• Disable-LocalUser
• Enable-LocalUser
• Get-LocalUser
• Remove-LocalUser
• Rename-LocalUser
• Set-LocalUser