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."このコマンドは、管理07 という名前のユーザー アカウントの説明を変更します。
例 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AccountNeverExpires
アカウントの有効期限が切れないことを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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: | False |
| Accept wildcard characters: | False |
-FullName
ユーザー アカウントの完全な名前を指定します。 完全な名前は、ユーザー アカウントのユーザー名とは異なります。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
このコマンドレットが変更するユーザー アカウントを指定します。 ユーザー アカウントを取得するには、コマンドレットを Get-LocalUser 使用します。
| Type: | Microsoft.PowerShell.Commands.LocalUser |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
このコマンドレットが変更するユーザー アカウントの名前を指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Password
ユーザー アカウントのパスワードを指定します。 ユーザー アカウントが Microsoft アカウントに接続されている場合は、パスワードを設定しないでください。
をGet-Credential使用Read-Host -AsSecureStringするかConvertTo-SecureString、パスワードの SecureString オブジェクトを作成できます。
Password パラメーターと NoPassword パラメーターを省略すると、Set-LocalUserユーザーのパスワードの入力を求められます。
| Type: | SecureString |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PasswordNeverExpires
パスワードの有効期限が切れるかどうかを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SID
このコマンドレットが変更するユーザー アカウントのセキュリティ ID (SID) を指定します。
| Type: | SecurityIdentifier |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UserMayChangePassword
ユーザーがユーザー アカウントのパスワードを変更できることを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
System.Management.Automation.SecurityAccountsManager.LocalUser
ローカル ユーザーをこのコマンドレットにパイプできます。
このコマンドレットに文字列をパイプできます。
SID をこのコマンドレットにパイプできます。
出力
None
このコマンドレットは、出力を返しません。
メモ
Windows PowerShell には、次のエイリアスが Set-LocalUser含まれています。
slu
PrincipalSource プロパティは、LocalUser、LocalGroup、および LocalPrincipal オブジェクトのプロパティで、オブジェクトのソースを記述します。 考えられるソースは次のとおりです。
- ローカル
- Active Directory
- Microsoft Entra グループ
- Microsoft アカウント
PrincipalSource は、Windows 10、Windows Server 2016、およびそれ以降のバージョンの Windows オペレーティング システムでのみサポートされています。 以前のバージョンの場合、プロパティは空白です。
関連リンク
PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示