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 コマンドレットは、ローカル ユーザー アカウントを変更します。 このコマンドレットは、ローカル ユーザー アカウントのパスワードをリセットできます。

Note

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

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

パラメーター

-AccountExpires

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

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

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

-AccountNeverExpires

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

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

-Confirm

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

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

-Description

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

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

-FullName

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

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

-InputObject

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

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

-Name

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

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

-Password

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

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

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

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

-PasswordNeverExpires

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

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

-SID

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

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

-UserMayChangePassword

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

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

-WhatIf

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

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

入力

System.Management.Automation.SecurityAccountsManager.LocalUser

ローカル ユーザーをこのコマンドレットにパイプできます。

String

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

SecurityIdentifier

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

出力

None

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

メモ

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

• slu

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

• ローカル
• Active Directory
• Microsoft Entra グループ
• Microsoft アカウント

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

関連リンク

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