#1 Global Leader in Data Protection & Ransomware Recovery

Change Managed Server Name/FQDN/IP in Veeam Backup & Replication

KB ID: 1905
Product: Veeam Backup & Replication | 7.0 | 8.0 | 9.0 | 9.5 | 10 | 11 | 12 | 12.1
Published: 2014-07-22
Last Modified: 2024-01-03
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please, try again later.

Usage Exceptions

The method documented in this article is only to be used for changing the Name/FQDN/IP of a managed server—specifically, those servers listed under the Managed Servers node of the Backup Infrastructure view.

Please be mindful of the following usage exceptions:

  • The method in this article cannot be used to change the information for a VMware Cloud Director server entry. Updating a Cloud Director entry requires direct assistance from Veeam Support. 
  • The method in this article cannot be used to change the information for machines listed inside a Protection Group.
  • This method is not intended to be used to change the hostname of the Veeam Backup Server itself. If the Veeam Backup & Replication console fails to start after the Veeam Backup Server hostname has changed; please reference: KB2350 and KB2127

Challenge

The Name/FQDN/IP of a Managed Server has changed and needs to be updated within Veeam Backup & Replication.
Example of where to find Managed Servers

Solution

Solves Name Change Only

This solution should only be used to change the vCenter Server hostname if it has changed, and not the database.

If the Name/FQDN/IP of the vCenter changed due to a reinstall or upgrade, and a new vCenter database was used, the Ref-IDs will have changed. Due to the changed Ref-IDs you will need to follow the documented process in www.veeam.com/KB1299

Before You Begin

Gather Old Machine Name From UI

Prior to running the commands below you need to identify the Name\FQDN\IP Veeam is using to communicate with the Managed Server currently. To do this, edit the entry for a Managed Server under Backup Infrastructure and note the “Name:”.

oldname
Example of a VMware Server

Disable MFA For Your Account (If MFA is Enabled)

If MFA is enabled for your account, PowerShell commands cannot be run.

For more information review KB4535: Veeam PowerShell Command Fails With: "Unable to connect to the server with MFA-enabled user account."

Managed Server Object Rename Procedure

Perform the following steps to change that Managed Server's name.

  1. Launch PowerShell from inside the Veeam Backup & Replication console. You can find the "PowerShell" button under the Main Menu's "Console" section.
openpsconsole
  1. The Veeam Backup & Replication PowerShell Toolkit will load.
  2. Run the following command:
$Servers = Get-VBRServer -name "old-name"
Replace old-name with the "Name" currently set for the Managed Server in the Veeam Backup and Replication Console.
Do not remove the quotes on either side.
  1. Run the following command next to change the name:
$Servers.SetName("new-name")
Replace new-name with the new name for the Managed Server; this can be an IP, Hostname, or FQDN. 
Do not remove the quotes on either side.
This change will go in to effect as soon as the command in Step 4 completes.
Example
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.