Set-LocalUser

モジュール:

Microsoft.PowerShell.LocalAccounts

ローカル ユーザー アカウントを変更します。

構文

Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-Name] <String>
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-InputObject] <LocalUser>
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-SID] <SecurityIdentifier>
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットは Set-LocalUser 、ローカル ユーザー アカウントを変更します。 このコマンドレットは、ローカル ユーザー アカウントのパスワードをリセットできます。

注意

Microsoft.PowerShell.LocalAccounts モジュールは、64 ビット システムの 32 ビット PowerShell では使用できません。

例

例 1: ユーザー アカウントの説明を変更する

Set-LocalUser -Name "Admin07" -Description "Description of this account."

このコマンドは、Admin07 という名前のユーザー アカウントの説明を変更します。

例 2: アカウントのパスワードを変更する

$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password

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

2 番目のコマンドでは、User02 という名前のユーザー アカウントを使用して Get-LocalUser取得します。 このコマンドは、アカウントを$UserAccount変数に格納します。

3 番目のコマンドは、新しいパスワードを格納されているユーザー アカウントに $UserAccount設定します。

パラメーター

-AccountExpires

ユーザー アカウントの有効期限を指定します。 DateTime オブジェクトを取得するには、コマンドレットをGet-Date使用します。

アカウントを期限切れにしない場合は、 AccountNeverExpires パラメーターを 指定します。

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

-AccountNeverExpires

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

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

-Confirm

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

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

-Description

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

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

-FullName

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

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

-InputObject

このコマンドレットが変更するユーザー アカウントを指定します。 ユーザー アカウントを取得するには、コマンドレットを Get-LocalUser 使用します。

Type:	Microsoft.PowerShell.Commands.LocalUser
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

このコマンドレットが変更するユーザー アカウントの名前を指定します。

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

-Password

ユーザー アカウントのパスワードを指定します。 ユーザー アカウントが Microsoft アカウントに接続されている場合は、パスワードを設定しないでください。

または、パスワードの SecureString オブジェクトを作成するために使用Read-Host -AsSecureStringGet-CredentialConvertTo-SecureStringできます。

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

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

-PasswordNeverExpires

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SID

このコマンドレットが変更するユーザー アカウントのセキュリティ ID (SID) を指定します。

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

-UserMayChangePassword

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

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

入力

System.Management.Automation.SecurityAccountsManager.LocalUser, System.String, System.Security.Principal.SecurityIdentifier

ローカル ユーザー、文字列、または SID をこのコマンドレットにパイプできます。

出力

None

このコマンドレットは出力を生成しません。

メモ

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

• ローカル

• Active Directory

• Azure Active Directory グループ

• Microsoft アカウント

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

関連リンク

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