Share via


Rename-Computer

Renomeia um computador.

Syntax

Rename-Computer
      [-ComputerName <String>]
      [-PassThru]
      [-DomainCredential <PSCredential>]
      [-LocalCredential <PSCredential>]
      [-NewName] <String>
      [-Force]
      [-Restart]
      [-WsmanAuthentication <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Este cmdlet só está disponível na plataforma Windows.

O Rename-Computer cmdlet renomeia o computador local ou um computador remoto. Ele renomeia um computador em cada comando.

Este cmdlet foi introduzido no Windows PowerShell 3.0.

Exemplos

Exemplo 1: Renomear o computador local

Este comando renomeia o computador local para Server044 e, em seguida, reinicia-o para tornar a alteração efetiva.

Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart

Exemplo 2: Renomear um computador remoto

Este comando renomeia o Srv01 computador para Server001. O computador não é reiniciado.

O parâmetro DomainCredential especifica as credenciais de um usuário que tem permissão para renomear computadores no domínio.

O parâmetro Force suprime o prompt de confirmação.

Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force

Parâmetros

-ComputerName

Renomeia o computador remoto especificado. A predefinição é o computador local.

Digite o nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado de um computador remoto. Para especificar o computador local, digite o nome do computador, um ponto (.) ou localhost.

Esse parâmetro não depende da comunicação remota do PowerShell. Você pode usar o parâmetro ComputerName mesmo Rename-Computer se o computador não estiver configurado para executar comandos remotos.

Type:String
Position:Named
Default value:Local Computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

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

-DomainCredential

Especifica uma conta de usuário que tem permissão para se conectar ao domínio. Credenciais explícitas são necessárias para renomear um computador que ingressou em um domínio.

Digite um nome de usuário, como User01 ou Domain01\User01, ou insira um objeto PSCredential , como um Get-Credential gerado pelo cmdlet.

Se você digitar um nome de usuário, esse cmdlet solicitará uma senha.

Para especificar uma conta de usuário que tenha permissão para se conectar ao computador especificado pelo parâmetro ComputerName, use o parâmetro LocalCredential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

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

-LocalCredential

Especifica uma conta de usuário que tem permissão para se conectar ao computador especificado pelo parâmetro ComputerName . A predefinição é o utilizador atual.

Digite um nome de usuário, como User01 ou Domain01\User01, ou insira um objeto PSCredential , como um Get-Credential gerado pelo cmdlet.

Se você digitar um nome de usuário, esse cmdlet solicitará uma senha.

Para especificar uma conta de usuário que tenha permissão para se conectar ao domínio, use o parâmetro DomainCredential .

Type:PSCredential
Position:Named
Default value:Current User
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Especifica um novo nome para o computador. Este parâmetro é obrigatório.

Os nomes padrão podem conter letras (), (A-Z), números (0-9) e hífenes (-), mas sem espaços ou pontos (.).a-z O nome não pode ser inteiramente composto por algarismos e não pode ter mais de 63 caracteres

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

-PassThru

Retorna os resultados do comando. Caso contrário, esse cmdlet não gerará nenhuma saída.

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

-Restart

Indica que esse cmdlet reinicia o computador que foi renomeado. Muitas vezes, é necessário reiniciar para tornar a alteração efetiva.

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

-WhatIf

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

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

-WsmanAuthentication

Especifica o mecanismo usado para autenticar as credenciais do usuário quando esse cmdlet usa o protocolo WSMan. Os valores aceitáveis para este parâmetro são:

  • Básica
  • CredSSP
  • Predefinição
  • Resumo
  • Kerberos
  • Negociar

O valor padrão é Default.

Para obter mais informações sobre os valores desse parâmetro, consulte Enumeração AuthenticationMechanism.

Aviso

A autenticação CredSSP (Credential Security Service Provider), na qual as credenciais do usuário são passadas para um computador remoto para ser autenticado, foi projetada para comandos que exigem autenticação em mais de um recurso, como acessar um compartilhamento de rede remoto. Este mecanismo aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, as credenciais que são passadas para ele podem ser usadas para controlar > a sessão de rede.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Este cmdlet não tem parâmetros que recebem entrada por valor. No entanto, você pode canalizar os valores das propriedades ComputerName e NewName dos objetos para esse cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

RenameComputerChangeInfo

Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto RenameComputerChangeInfo .

Notas

Este cmdlet só está disponível em plataformas Windows.