Rename-LocalUser

Referenz

Modul:: Microsoft.PowerShell.LocalAccounts

Benennt ein lokales Benutzerkonto um.

Syntax

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>]

Beschreibung

Das Cmdlet Rename-LocalUser benennt ein lokales Benutzerkonto um.

Anmerkung

Das Microsoft.PowerShell.LocalAccounts-Modul ist in 32-Bit-PowerShell auf einem 64-Bit-System nicht verfügbar.

Beispiele

Beispiel 1: Umbenennen eines Benutzerkontos

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

Mit diesem Befehl wird das Benutzerkonto namens "Admin02" umbenannt.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Gibt das Benutzerkonto an, das dieses Cmdlet umbenennt. Verwenden Sie zum Abrufen eines Benutzerkontos das cmdlet Get-LocalUser.

Typ:	Microsoft.PowerShell.Commands.LocalUser
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Gibt den Namen des Benutzerkontos an, das dieses Cmdlet umbenennt.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-NewName

Gibt einen neuen Namen für das Benutzerkonto an.

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SID

Gibt die Sicherheits-ID (SID) eines Benutzerkontos an, das dieses Cmdlet umbenennt.

Typ:	SecurityIdentifier
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

System.Management.Automation.SecurityAccountsManager.LocalUser

Sie können einen lokalen Benutzer an dieses Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge an dieses Cmdlet weiterleiten.

SecurityIdentifier

Sie können eine SID an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Rename-LocalUser:

rnlu

Die eigenschaft PrincipalSource ist eine Eigenschaft für LocalUser, LocalGroup-und LocalPrincipal-Objekte, die die Quelle des Objekts beschreiben. Die möglichen Quellen sind wie folgt:

Lokal
Active Directory
Microsoft Entra-Gruppe
Microsoft-Konto

PrincipalSource- wird nur von Windows 10, Windows Server 2016 und höheren Versionen des Windows-Betriebssystems unterstützt. Bei früheren Versionen ist die Eigenschaft leer.

Freigeben über