Set-LocalUser

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

構文

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 -AsSecureStringGet-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 プロパティは、オブジェクトのソースを記述する LocalUserLocalGroup、および LocalPrincipal オブジェクトのプロパティです。 考えられるソースは次のとおりです。

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

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