Share via

Rename-LocalUser

  • リファレンス
モジュール:
Microsoft.PowerShell.LocalAccounts

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

構文

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 、ローカル ユーザー アカウントの名前を変更します。

Note

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

例

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

Rename-LocalUser -Name "Admin02" -NewName "AdminContoso02"

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

パラメーター

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-NewName

ユーザー アカウントの新しい名前を指定します。

Type:String
Position:1
Default value:None
Required:True
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

-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

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

String

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

SecurityIdentifier

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

出力

None

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

メモ

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

  • rnlu

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

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

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