Rename-Computer
Cambia el nombre de un ordenador.
Sintaxis
Default (Es el valor predeterminado).
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 utiliza 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | Local Computer |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Obliga a que el comando se ejecute sin pedir confirmación del usuario.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | Current User |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-PassThru
Devuelve los resultados del comando. De lo contrario, este cmdlet no genera ninguna salida.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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
- Resumen
- Kerberos
- Negociar
El valor predeterminado es Default.
Para obtener más información sobre los valores de este parámetro, consulte Enumeración de Mecanismo de Autenticació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 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Valores aceptados: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
None
Este cmdlet no tiene parámetros que toman la entrada por valor. Sin embargo, puede canalizar los valores de 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.
