Rename-Computer

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Cambia el nombre de un equipo.

Syntax

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 Rename-Computer cmdlet cambia el nombre del equipo local o de un equipo remoto. En cada comando cambia el nombre de un equipo.

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 y, a Server044 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 Srv01 equipo 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.

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

Parámetros

-ComputerName

Cambia el nombre del equipo remoto especificado. La opción predeterminada 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 aunque el equipo no esté configurado para ejecutar comandos remotos.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-DomainCredential

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

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

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 .

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 PSCredential , como uno generado por el Get-Credential cmdlet .

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 .

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

-NewName

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

Los nombres estándar pueden contener letras (), (a-zA-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.

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

-PassThru

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

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

-Restart

Indica que este cmdlet reinicia el equipo cuyo nombre se ha cambiado. A menudo es necesario reiniciar para que el cambio surta efecto.

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

-WhatIf

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

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

-WsmanAuthentication

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

  • Basic
  • CredSSP
  • Valor predeterminado
  • Digest
  • Kerberos
  • Negociar

El valor predeterminado es Default.

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

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 el riesgo de seguridad de la operación remota. Si el equipo remoto está en peligro, se pueden usar las credenciales que se pasan a ella para controlar > la sesión de red.

Este parámetro se incorporó en 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 no tiene parámetros que toman la entrada por valor. Sin embargo, puede canalizar los valores de las propiedades ComputerName y NewName de los 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.