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

Note

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 パラメーターまたはパスワード パラメーターを指定しません。 アカウントの有効期限が切れないか、パスワードが設定されていません。

例 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 オブジェクトを取得できます。 このパラメーターを指定しない場合、アカウントは期限切れになりません。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AccountNeverExpires

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Disabled

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-FullName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

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

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

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoPassword

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Password

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

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

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PasswordNeverExpires

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UserMayNotChangePassword

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Note

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