Condividi tramite

Rename-LocalUser

  • Riferimento
Modulo:
Microsoft.PowerShell.LocalAccounts

Rinomina un account utente locale.

Sintassi

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

Descrizione

Il Rename-LocalUser cmdlet rinomina un account utente locale.

Nota

Il modulo Microsoft.PowerShell.LocalAccounts non è disponibile in PowerShell a 32 bit in un sistema a 64 bit.

Esempio

Esempio 1: Rinominare un account utente

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

Questo comando rinomina l'account utente denominato Amministrazione 02.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifica l'account utente rinominato da questo cmdlet. Per ottenere un account utente, usare il cmdlet Get-LocalUser.

Type:Microsoft.PowerShell.Commands.LocalUser
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifica il nome dell'account utente rinominato da questo cmdlet.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NewName

Specifica un nuovo nome per l'account utente.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SID

Specifica l'ID di sicurezza (SID) di un account utente rinominato da questo cmdlet.

Type:SecurityIdentifier
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

System.Management.Automation.SecurityAccountsManager.LocalUser

È possibile inviare tramite pipe un utente locale a questo cmdlet.

String

È possibile inviare tramite pipe una stringa a questo cmdlet.

SecurityIdentifier

È possibile inviare tramite pipe un SID a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

Windows PowerShell include gli alias seguenti per Rename-LocalUser:

  • rnlu

La proprietà PrincipalSource è una proprietà sugli oggetti LocalUser, LocalGroup e LocalPrincipal che descrivono l'origine dell'oggetto. Le possibili origini sono le seguenti:

  • Locale
  • Active Directory
  • Gruppo Microsoft Entra
  • Account Microsoft

PrincipalSource è supportato solo da Windows 10, Windows Server 2016 e versioni successive del sistema operativo Windows. Per le versioni precedenti, la proprietà è vuota.