Rename-LocalUser

Odwołanie

Moduł:: Microsoft.PowerShell.LocalAccounts

Zmienia nazwę konta użytkownika lokalnego.

Składnia

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

Opis

Polecenie cmdlet Rename-LocalUser zmienia nazwę konta użytkownika lokalnego.

Nuta

Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.

Przykłady

Przykład 1. Zmiana nazwy konta użytkownika

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

To polecenie zmienia nazwę konta użytkownika o nazwie Admin02.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-InputObject

Określa konto użytkownika, którego nazwa tego polecenia cmdlet zostanie zmieniona. Aby uzyskać konto użytkownika, użyj polecenia cmdlet Get-LocalUser.

Typ:	Microsoft.PowerShell.Commands.LocalUser
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Name

Określa nazwę konta użytkownika, którego nazwa jest zmieniana przez to polecenie cmdlet.

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-NewName

Określa nową nazwę konta użytkownika.

Typ:	String
Position:	1
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SID

Określa identyfikator zabezpieczeń (SID) kont użytkowników, których nazwa tego polecenia cmdlet zostanie zmieniona.

Typ:	SecurityIdentifier
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

System.Management.Automation.SecurityAccountsManager.LocalUser

Możesz przekazać użytkownikowi lokalnemu potok do tego polecenia cmdlet.

String

Możesz przekazać ciąg do tego polecenia cmdlet.

SecurityIdentifier

Do tego polecenia cmdlet można przekazać identyfikator SID.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Program Windows PowerShell zawiera następujące aliasy dla Rename-LocalUser:

rnlu

Właściwość PrincipalSource jest właściwością LocalUser, LocalGroupi obiektów LocalPrincipal opisujących źródło obiektu. Możliwe źródła są następujące:

Lokalny
Active Directory
Grupa Microsoft Entra
Konto Microsoft

PrincipalSource jest obsługiwana tylko przez system Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. W przypadku wcześniejszych wersji właściwość jest pusta.