Compartilhar via

Rename-Computer

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

Renomeia um computador.

Sintaxe

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

Description

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

Esse cmdlet foi introduzido no Windows PowerShell 3.0.

Exemplos

Exemplo 1: renomear o computador local

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

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

Exemplo 2: renomear um computador remoto

Esse comando renomeia o computador Srv01 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. O padrã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 de Rename-Computer mesmo se o computador não estiver configurado para executar comandos remotos.

Tipo:String
Cargo:Named
Valor padrão:Local Computer
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 ingressado em um domínio.

Digite um nome de usuário, como ou , ou insira um objeto PSCredential , como um 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.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LocalCredential

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

Digite um nome de usuário, como ou , ou insira um objeto PSCredential , como um 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.

Tipo:PSCredential
Cargo:Named
Valor padrão:Current User
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NewName

Especifica um novo nome para o computador. Esse parâmetro é necessário.

Os nomes padrão podem conter letras (a-z), (A-Z), números (0-9) e hifens (-), mas nenhum espaço ou período (.). O nome pode não consistir inteiramente em dígitos e pode não ter mais de 63 caracteres

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Protocol

Especifica qual protocolo usar para renomear o computador. Os valores aceitáveis para esse parâmetro são: WSMan e DCOM. O valor padrão é DCOM.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Tipo:String
Valores aceitos:DCOM, WSMan
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Restart

Indica que esse cmdlet reinicia o computador que foi renomeado. Uma reinicialização geralmente é necessária para tornar a alteração eficaz.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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ásico
  • credSSP
  • padrão
  • Digest
  • Kerberos
  • negociar

O valor padrão é Padrão.

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

Aviso

A autenticação credSSP (Provedor de Serviços de Segurança de Credencial), na qual as credenciais do usuário são passadas para um computador remoto a ser autenticado, foi projetada para comandos que exigem autenticação em mais de um recurso, como acessar um compartilhamento de rede remoto. Esse mecanismo aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, as credenciais passadas para ele poderão ser usadas para controlar > sessão de rede.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Tipo:String
Valores aceitos:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Esse cmdlet não tem parâmetros que levam entrada por valor. No entanto, você pode canalizar os valores do computername e propriedades do NewName de objetos para este cmdlet.

Saídas

ComputerChangeInfo

Esse cmdlet retornará um objeto ComputerChangeInfo, se você especificar o parâmetro PassThru. Caso contrário, ele não retornará nenhuma saída.