Rename-LocalUser
ローカル ユーザー アカウントの名前を変更します。
構文
Rename-LocalUser
[-InputObject] <LocalUser>
[-NewName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Rename-LocalUser
[-Name] <String>
[-NewName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Rename-LocalUser
[-NewName] <String>
[-SID] <SecurityIdentifier>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Rename-LocalUser
コマンドレットは、ローカル ユーザー アカウントの名前を変更します。
手記
Microsoft.PowerShell.LocalAccounts モジュールは、64 ビット システムの 32 ビット PowerShell では使用できません。
例
例 1: ユーザー アカウントの名前を変更する
Rename-LocalUser -Name "Admin02" -NewName "AdminContoso02"
このコマンドは、Admin02 という名前のユーザー アカウントの名前を変更します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
このコマンドレットの名前を変更するユーザー アカウントを指定します。 ユーザー アカウントを取得するには、Get-LocalUser コマンドレットを使用します。
型: | Microsoft.PowerShell.Commands.LocalUser |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
このコマンドレットの名前を変更するユーザー アカウントの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-NewName
ユーザー アカウントの新しい名前を指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SID
このコマンドレットの名前を変更するユーザー アカウントのセキュリティ ID (SID) を指定します。
型: | SecurityIdentifier |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
System.Management.Automation.SecurityAccountsManager.LocalUser
ローカル ユーザーをこのコマンドレットにパイプできます。
このコマンドレットに文字列をパイプできます。
SID をこのコマンドレットにパイプできます。
出力
None
このコマンドレットは出力を返しません。
メモ
Windows PowerShell には、Rename-LocalUser
の次のエイリアスが含まれています。
rnlu
PrincipalSource プロパティは、LocalUser 、LocalGroup、およびオブジェクトのソースを記述する LocalPrincipal オブジェクトプロパティです。 考えられるソースは次のとおりです。
- 地元の
- Active Directory
- Microsoft Entra グループ
- Microsoft アカウント
PrincipalSource は、Windows 10、Windows Server 2016、およびそれ以降のバージョンの Windows オペレーティング システムでのみサポートされます。 以前のバージョンの場合、プロパティは空白です。
関連リンク
PowerShell