Partilhar via

Rename-LocalUser

  • Referência
Módulo:
Microsoft.PowerShell.LocalAccounts

Renomeia uma conta de usuário local.

Sintaxe

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

Description

O Rename-LocalUser cmdlet renomeia uma conta de usuário local.

Nota

O módulo Microsoft.PowerShell.LocalAccounts não está disponível no PowerShell de 32 bits em um sistema de 64 bits.

Exemplos

Exemplo 1: Renomear uma conta de usuário

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

Este comando renomeia a conta de usuário chamada Admin02.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

Especifica a conta de usuário que esse cmdlet renomeia. Para obter uma conta de usuário, use o cmdlet Get-LocalUser.

Tipo:Microsoft.PowerShell.Commands.LocalUser
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome da conta de usuário que esse cmdlet renomeia.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-NewName

Especifica um novo nome para a conta de usuário.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SID

Especifica a ID de segurança (SID) de uma conta de usuário que esse cmdlet renomeia.

Tipo:SecurityIdentifier
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

System.Management.Automation.SecurityAccountsManager.LocalUser

Você pode canalizar um usuário local para esse cmdlet.

String

Você pode canalizar uma cadeia de caracteres para este cmdlet.

SecurityIdentifier

Você pode canalizar um SID para este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

O Windows PowerShell inclui os seguintes aliases para Rename-LocalUser:

  • rnlu

A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroup e LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:

  • Local
  • Active Directory
  • Grupo Microsoft Entra
  • Conta Microsoft

PrincipalSource é suportado apenas pelo Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Para versões anteriores, a propriedade está em branco.