New-LocalUser

構文

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 コマンドレットは、ローカル ユーザー アカウントを作成します。 このコマンドレットは、ローカル ユーザー アカウントを作成します。

例

例 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

-AccountNeverExpires

-Confirm

-Description

-Disabled

-FullName

-Name

-NoPassword

-Password

-PasswordNeverExpires

-UserMayNotChangePassword

-WhatIf

入力

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

関連リンク

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