Compartir a través de

Rename-Computer

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Cambia el nombre de un equipo.

Sintaxis

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet Rename-Computer cambia el nombre del equipo local o de un equipo remoto. Cambia el nombre de un equipo en cada comando.

Este cmdlet se introdujo en Windows PowerShell 3.0.

Ejemplos

Ejemplo 1: Cambiar el nombre del equipo local

Este comando cambia el nombre del equipo local a Server044 y, a continuación, lo reinicia para que el cambio sea efectivo.

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

Ejemplo 2: Cambiar el nombre de un equipo remoto

Este comando cambia el nombre del equipo de Srv01 a Server001. No se reinicia el equipo.

El parámetro DomainCredential especifica las credenciales de un usuario que tiene permiso para cambiar el nombre de los equipos del dominio.

El parámetro Force suprime el mensaje de confirmación.

$renameParams = @{
    ComputerName = "Srv01"
    NewName = "Server001"
    DomainCredential = "Domain01\Admin01"
    Force = $true
}
Rename-Computer @renameParams

Parámetros

-ComputerName

Cambia el nombre del equipo remoto especificado. El valor predeterminado es el equipo local.

Escriba el nombre NetBIOS, una dirección IP o un nombre de dominio completo de un equipo remoto. Para especificar el equipo local, escriba el nombre del equipo, un punto (.) o localhost.

Este parámetro no se basa en la comunicación remota de PowerShell. Puede usar el parámetro ComputerName de Rename-Computer incluso si el equipo no está configurado para ejecutar comandos remotos.

Tipo:String
Posición:Named
Valor predeterminado:Local Computer
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DomainCredential

Especifica una cuenta de usuario que tiene permiso para conectarse al dominio. Se requieren credenciales explícitas para cambiar el nombre de un equipo unido a un dominio.

Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto de PSCredential de, como uno generado por el cmdlet Get-Credential.

Si escribe un nombre de usuario, este cmdlet le pedirá una contraseña.

Para especificar una cuenta de usuario que tenga permiso para conectarse al equipo especificado por el parámetro ComputerName, use el parámetro LocalCredential.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LocalCredential

Especifica una cuenta de usuario que tiene permiso para conectarse al equipo especificado por el parámetro computerName . El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto de PSCredential de, como uno generado por el cmdlet Get-Credential.

Si escribe un nombre de usuario, este cmdlet le pedirá una contraseña.

Para especificar una cuenta de usuario que tenga permiso para conectarse al dominio, use el parámetro DomainCredential.

Tipo:PSCredential
Posición:Named
Valor predeterminado:Current User
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NewName

Especifica un nuevo nombre para el equipo. Este parámetro es obligatorio.

Los nombres estándar pueden contener letras (a-z), (A-Z), números (0-9) y guiones (-), pero sin espacios ni puntos (.). Es posible que el nombre no conste por completo de dígitos y que no tenga más de 63 caracteres.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Devuelve los resultados del comando. De lo contrario, este cmdlet no genera ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Restart

Indica que este cmdlet reinicia el equipo cuyo nombre se ha cambiado. A menudo, se requiere un reinicio para hacer que el cambio sea efectivo.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WsmanAuthentication

Especifica el mecanismo que se usa para autenticar las credenciales de usuario cuando este cmdlet usa el protocolo WSMan. Los valores aceptables para este parámetro son:

  • Básico
  • CredSSP
  • Predeterminado
  • de resumen de
  • Kerberos
  • negociar

El valor predeterminado es valor predeterminado.

Para obtener más información sobre los valores de este parámetro, vea AuthenticationMechanism Enumeration.

Advertencia

La autenticación del proveedor de servicios de seguridad de credenciales (CredSSP), en la que las credenciales de usuario se pasan a un equipo remoto para autenticarse, está diseñada para comandos que requieren autenticación en más de un recurso, como el acceso a un recurso compartido de red remoto. Este mecanismo aumenta el riesgo de seguridad de la operación remota. Si el equipo remoto está en peligro, las credenciales que se le pasan se pueden usar para controlar > la sesión de red.

Este parámetro se introdujo en Windows PowerShell 3.0.

Tipo:String
Valores aceptados:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Este cmdlet no tiene parámetros que toman la entrada por valor. Sin embargo, puede canalizar los valores de ComputerName y Propiedades newName de objetos a este cmdlet.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

RenameComputerChangeInfo

Cuando se usa el parámetro PassThru, este cmdlet devuelve un objeto RenameComputerChangeInfo.

Notas

Este cmdlet solo está disponible en plataformas Windows.